Документація API/CRM/Завдання

Завдання

Дзвінки, зустрічі, нагадування з прив’язкою до будь-якого запису CRM. Право ролі: task.

Маршрути

GET/task

Список завдань з пагінацією, фільтрами й total.

право: task.view2 очк.

GET/task/{id}

Одна картка.

право: task.view1 очк.

GET/task/count

Лише кількість за тими самими фільтрами (голе число).

право: task.view2 очк.

POST/task

Створити.

право: task.create5 очк.

PUT/task/{id}

Оновити.

право: task.update5 очк.

DELETE/task/{id}

Видалити.

право: task.delete5 очк.

GET/task/deleted?since=...

Видалені записи, див. розділ Синхронізація.

право: task.view2 очк.

Усі поля

Обов’язкове лише subject. Теги й доп. поля (extra_fields) описані в розділі Вкладені дані.

Поле	Тип	Обмеження	Опис
`subject`обов.	рядок	≤ 80 симв.	Тема завдання.
`description`	рядок	≤ 16000 симв.	Опис.
`subtask_json`	рядок		Підзавдання (чек-лист) у вигляді JSON-рядка, як його зберігає інтерфейс.
`start_date`	дата-час		Початок.
`end_date`	дата-час		Термін.
`end_date_id`	id		Пресет терміну з інтерфейсу (службове).
`remind_at`	дата-час		Коли нагадати.
`remind_id`	рядок		Пресет нагадування з інтерфейсу (службове).
`is_private`	bool		Приватне завдання.
`is_archived`	bool		В архіві. Архівні записи приховує параметр is_archived=true.
`priority`	ціле		Пріоритет.
`time_estimate`	ціле		Оцінка часу, секунди.
`time_spent`	ціле		Витрачено часу, секунди.
`owner_id`	id		Відповідальний користувач (/user). Якщо не передано, це користувач токена.
`parent_id`	id		Батьківське завдання.
`tags`	масив Tag		Теги: [{"id": 3}] або [{"name": "VIP"}]. Передані замінюють усі теги запису. Див. «Вкладені дані».
`type_id`	id		Тип завдання (/lookup?type=task_type).
`status_id`	id		Статус завдання (/lookup?type=task_status).
`entity_type`	рядок		До чого прив’язана: contact, account, lead, opportunity, order, invoice тощо.
`entity_id`	id		Id запису, до якого прив’язана.
`entity_data`	interface		Короткі дані прив’язаного запису (лише у відповіді).
`project_id`	id		Проєкт. Задається лише при створенні; спроба змінити через PUT поверне 422.
`project_stage_id`	id		Етап проєкту (разом із project_id). Лише при створенні.
`sla_response_due_at`	дата-час		SLA: відповісти до.
`sla_resolution_due_at`	дата-час		SLA: вирішити до.
`sla_responded_at`	дата-час		SLA: коли відповіли.
`sla_resolved_at`	дата-час		SLA: коли вирішили.
`recurring_id`	id		Шаблон повторення, з якого створено завдання.
`recurring_date`	дата-час		Дата спрацювання шаблону.
`id`лише читання	ціле		Ідентифікатор запису.
`is_overdue`лише читання	bool
`completed_at`лише читання	дата-час
`created_at`лише читання	дата-час		Час створення.
`updated_at`лише читання	дата-час		Час останньої зміни, на ньому будується інкрементальна синхронізація.
`deleted_at`лише читання	дата-час		Час видалення (у звичайних відповідях завжди null).
`created_by_id`лише читання	id		Хто створив запис.
`shop_id`лише читання	id		Магазин (філія), ставиться з профілю користувача.
`updated_user`лише читання	об’єкт User		Хто змінив запис останнім.
`sub`лише читання	рядок		Службове поле, ігноруйте.

Вкладені масиви

children: лише у відповіді (expand=Children).
extra_fields: пишеться в тілі POST/PUT, формат див. у розділі Вкладені дані.

Повʼязані обʼєкти для ?expand= (7)

Без expand приходять як null; писати їх не можна, передавайте відповідне *_id.

Owner → UserCreatedBy → UserShop → ShopType → LookupStatus → LookupProject → ProjectProjectStage → ProjectStage

Службові поля у відповіді, ігноруйте: OldTask.

Приклад

Передзвонити клієнту завтра о 10:00

POST /api/v1/task
{
  "subject": "Передзвонити щодо розрахунку",
  "entity_type": "lead",
  "entity_id": 15,
  "owner_id": 7,
  "end_date": "2026-10-01T10:00:00+03:00"
}

Завдання менеджера в статусі 21, найтерміновіші першими

GET /api/v1/task?filter[owner_id;eq]=7&filter[status_id;eq]=21&order=end_date