Görev / hatırlatma ekle


POST https://app.apsilo.com/api/public/v1/tasks

Görev bir kayda (recordId) ya da doğrudan kişiye (contactId) bağlanır. Vadesi geldiğinde atanan kullanıcıya bildirim gider.

Gerekli kapsam: records:write

Parametreler

Parametre	Yer	Tip	Gereklilik	Açıklama
`Idempotency-Key`	başlık	string	isteğe bağlı	İsteğe özgü benzersiz değer (1–255 yazdırılabilir ASCII; ör. UUID). Aynı anahtar + aynı yol ve gövde 24 saat içinde kaydedilmiş yanıtı döner (`Idempotent-Replayed: true`); farklı gövde veya işlenmekte olan istek `409 IDEMPOTENCY_CONFLICT`. Hata yanıtları saklanmaz.
`X-Request-Id`	başlık	string	isteğe bağlı	İsteğe bağlı istek kimliğiniz (8–100 karakter: harf, rakam, `._:-`); yanıtta aynen döner ve kayıtlara işlenir.

İstek gövdesi

Alan	Tip	Gereklilik	Açıklama
`title`	string	zorunlu
`dueAt`	string (date-time)	zorunlu	Vade; geldiğinde atanan kişiye bildirim gider
`recordId`	string,null (uuid)	isteğe bağlı
`contactId`	string,null (uuid)	isteğe bağlı	`recordId` yoksa zorunlu
`assignedUserId`	string,null (uuid)	isteğe bağlı


{
  "recordId": "0b9e4c1a-6f2d-4a7b-9c3e-000000000012",
  "title": "Vatandaşı arayıp bilgi ver",
  "dueAt": "2026-10-12T09:00:00+03:00",
  "assignedUserId": "0b9e4c1a-6f2d-4a7b-9c3e-000000000013"
}

Yanıtlar

Durum	Açıklama
`201`	Oluşturulan görev
`401`	Kimlik doğrulanamadı. Olası kodlar: `API_KEY_INVALID`, `API_KEY_REVOKED`, `API_KEY_EXPIRED`.
`403`	Erişim reddedildi. Olası kodlar: `FEATURE_NOT_LICENSED`, `API_SCOPE_MISSING`, `IP_NOT_ALLOWED`, `LICENSE_EXPIRED`, `LICENSE_NOT_FOUND`, `FORBIDDEN`.
`404`	Bulunamadı. Olası kodlar: `NOT_FOUND`.
`409`	Çakışma. Olası kodlar: `CONFLICT`, `IDEMPOTENCY_CONFLICT`, `MEDIA_IN_USE`, `SOCIAL_APPROVAL_REQUIRED`, `SOCIAL_POST_NOT_EDITABLE`.
`422`	İşlenemeyen istek. Olası kodlar: `VALIDATION_FAILED`, `MESSAGING_WINDOW_CLOSED`, `CHANNEL_ACCOUNT_MISSING`, `CONTACT_BLOCKED`, `STORAGE_LIMIT_REACHED`, `SOCIAL_POST_INVALID`, `SOCIAL_PLATFORM_UNAVAILABLE`.
`429`	Hız sınırı aşıldı. Olası kodlar: `RATE_LIMITED`.
`500`	Sunucu hatası. Olası kodlar: `INTERNAL`.

Yanıt gövdesi

Alan	Tip	Gereklilik	Açıklama
`data`	object	zorunlu