# To-do дела CRM

Новые дела типа `CRM_TODO` создаются и обновляются здесь. Чтение и список остаются в [делах CRM](./activities.md): используйте `GET /v1/activities/:id` или список с фильтром `providerId=CRM_TODO`.

Скоуп: `crm`. Для записи нужен ключ с режимом записи. Все ответы о деле имеют ту же форму, что `GET /v1/activities/:id`.

## Операции

- [Создать to-do](./activity-todos/create.md) — `POST /v1/activity-todos`
- [Изменить to-do](./activity-todos/update.md) — `PATCH /v1/activity-todos/:id`

## Выбор метода Битрикс24 при PATCH

| Поля запроса | Метод Битрикс24 |
|---|---|
| Только `deadline` | `crm.activity.todo.updateDeadline` |
| Только `description` | `crm.activity.todo.updateDescription` |
| Только `responsibleId` | `crm.activity.todo.updateResponsibleUser` |
| Любая другая комбинация без `colorId` | `crm.activity.todo.update` с сохранением пропущенных полей |

При полном обновлении сервис сохраняет существующие напоминания, файлы и блоки дела. Цвет можно задать при создании; PATCH с допустимым `colorId` возвращает 422, потому что полное обновление Битрикс24 может стереть настройки, добавленные параллельно. Цвет вне палитры возвращает 400. Завершённое to-do не изменяется и возвращает 422.