---
title: "Сделать из дела задачу"
method: POST
path: "/api/v1/crm/engagements/{id}/task"
tags: ["CRM links"]
---

# Сделать из дела задачу

`POST /api/v1/crm/engagements/{id}/task`

## Request

- Base URL: `https://erp.akeda.ru`
- URL: `https://erp.akeda.ru/api/v1/crm/engagements/{id}/task`
- Auth: one of:
  - HTTP bearer
  - OAuth 2 (authorization code, authorization URL `https://erp.akeda.ru/oauth2/authorize`, token URL `https://erp.akeda.ru/oauth2/token`, scopes: `akeda:delegate`)

Заводит из дела полноценную задачу модуля «Задачи» со связью в обе стороны: дело помнит задачу, задача ссылается на карточку CRM. Нужен подключённый модуль «Задачи»

## Request body

- CRMEngagementTaskInput
  - `section_id` string, uuid, required
  - `title` string: Название задачи; по умолчанию - название дела
  - `description` string: Описание задачи; по умолчанию - подробности дела
  - `due_at` string, date-time, nullable: Срок задачи; по умолчанию - срок дела
  - `executor_id` integer, nullable: Исполнитель; по умолчанию - ответственный за дело

## Response `201`

Дело со ссылкой на задачу

- CRMEngagement
  - `id` string, uuid, required
  - `entity_type` 'lead' | 'deal' | 'customer', required
  - `entity_id` string, uuid, required
  - `kind` string, required: Код вида дела из справочника «Виды дел» кабинета (GET /api/v1/crm/engagement-kinds). Новому кабинету заведены call, meeting, measurement, email и task; свои виды кабинет добавляет в справочнике
  - `title` string, required
  - `description` string, required: Подробности дела: что обсудить, адрес встречи
  - `due_at` string, date-time
  - `done_at` string, date-time: Пусто, пока дело не выполнено
  - `remind_at` string, date-time: Когда напомнить ответственному
  - `reminded_at` string, date-time: Когда напоминание ушло в центр уведомлений
  - `repeat` 'none' | 'daily' | 'weekly' | 'monthly', required: Повтор дела: закрытое повторяющееся дело само заводит следующее
  - `ends_at` string, date-time: Конец дела; срок due_at - его начало
  - `all_day` boolean: Дело на весь день: начало и конец - границы суток в поясе timezone
  - `timezone` string: Часовой пояс того, кто планировал (IANA, например Europe/Moscow): в нём встреча стоит в календаре
  - `location` string: Адрес встречи; только у видов с галочкой «Адрес»
  - `conference_url` string: Ссылка видеовстречи; только у видов с галочкой «Видеовстреча»
  - `conference_provider` '' | 'telemost' | 'personal' | 'link': Откуда ссылка: комната Телемоста, личная ссылка или вставленная руками
  - `conference_id` string: Номер комнаты Телемоста
  - `participant_ids` integer[]: Коллеги-участники (номера сотрудников из GET /api/v1/crm/members); ответственный - организатор и в список не входит
  - `calendar_event_id` string, uuid
  - `task_id` string, uuid
  - `owner_id` integer
  - `owner_name` string
  - `entity_title` string: Название карточки дела (в списке «Мои дела»)
  - `warnings` string[]: Дело сохранено, но событие календаря не заведено или не обновлено
  - `created_by` integer, required
  - `created_at` string, date-time, required
  - `updated_at` string, date-time, required

## Other responses

- `400`: Некорректный запрос или нарушение бизнес-правила
- `401`: Сессия, ключ или кабинет не подтверждены
- `403`: Текущая роль не имеет требуемого права
- `404`: Запись не найдена или не видима текущему пользователю
- `409`: Конфликт версии, идемпотентности или бизнес-состояния

---

[API](https://skmtc.dev/akeda/apis/akeda-erp-client-api.md) · [All operations](https://skmtc.dev/akeda/apis/akeda-erp-client-api/llms.txt) · [OpenAPI document](https://skmtc.dev/akeda/apis/akeda-erp-client-api/revisions/3c60ded179f2?raw)