Задачи

Управление задачами портала: создание, чтение, обновление, удаление, фильтрация, агрегация. Задача — единица работы с ответственным, постановщиком, сроком и статусом. У одной задачи могут быть комментарии и записи учёта времени — это отдельные вложенные ресурсы.

Битрикс24 API: tasks.task.* Скоуп: tasks

Создать задачу

POST /v1/tasks

Создаёт новую задачу. Минимум — название и ответственный.

Поля запроса (body)

Полный список полей — GET /v1/tasks/fields. Поля id, dateStart, activityDate, realStatus заполняются системой и в body не передаются.

Служебные поля задачи можно задавать

Кроме createdBy, при создании принимаются changedBy, closedBy, statusChangedBy, createdDate, changedDate, closedDate. Битрикс24 сохраняет переданные значения, а Вайбкод — обёртка над ним и не запрещает того, что разрешает платформа. Принимаются оба написания — и createdBy, и CREATED_BY. Передавайте одно из двух, а не оба сразу: при обоих в одном теле применится то, которое встретится позже. Те же поля принимаются и при обновлении — там же разобрано, что остаётся в журнале задачи и как ведёт себя дата без часового пояса.

Передавайте только существующего сотрудника. Битрикс24 не проверяет идентификатор пользователя на существование ни в createdBy, ни в changedBy, closedBy, statusChangedBy — он запишет любое число. Задача с несуществующим постановщиком перестаёт управляться через API: отказ приходит и на дальнейшее обновление, и на удаление, причём даже ключу администратора и напрямую в Битрикс24, минуя нас. Отменить это через API нельзя. Список сотрудников: GET /v1/users.

Важно: название длиннее 250 символов Битрикс24 не отклоняет — он молча обрезает его до 250. Эмодзи перед обрезкой заменяются служебной последовательностью, поэтому название с эмодзи обрезается раньше. Проверяйте title в ответе, если длина названия важна.

Важно: xmlId длиннее 50 символов не отклоняется — сохраняются только первые 50. Фильтр filter[xmlId] ищет по точному совпадению, поэтому по исходному длинному значению задача не найдётся. Чтобы найти задачу, когда ответ на создание потерян, передавайте xmlId не длиннее 50 символов, например UUID из 36 символов, и ищите её через GET /v1/tasks?filter[xmlId]=<значение>.

Примеры

curl — личный ключ

curl -X POST "https://vibecode.bitrix24.tech/v1/tasks" \
  -H "X-Api-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Подготовить отчёт за квартал",
    "responsibleId": 1,
    "priority": 2,
    "deadline": "2026-05-19T18:00:00+03:00"
  }'

curl — OAuth-приложение

curl -X POST "https://vibecode.bitrix24.tech/v1/tasks" \
  -H "X-Api-Key: YOUR_APP_KEY" \
  -H "Authorization: Bearer USER_SESSION_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Подготовить отчёт за квартал",
    "responsibleId": 1,
    "priority": 2,
    "deadline": "2026-05-19T18:00:00+03:00"
  }'

JavaScript — личный ключ

const res = await fetch('https://vibecode.bitrix24.tech/v1/tasks', {
  method: 'POST',
  headers: {
    'X-Api-Key': 'YOUR_API_KEY',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    title: 'Подготовить отчёт за квартал',
    responsibleId: 1,
    priority: 2,
    deadline: '2026-05-19T18:00:00+03:00',
  }),
})

const { success, data } = await res.json()
console.log('ID новой задачи:', data.id)

JavaScript — OAuth-приложение

const res = await fetch('https://vibecode.bitrix24.tech/v1/tasks', {
  method: 'POST',
  headers: {
    'X-Api-Key': 'YOUR_APP_KEY',
    'Authorization': 'Bearer USER_SESSION_TOKEN',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    title: 'Подготовить отчёт за квартал',
    responsibleId: 1,
    priority: 2,
    deadline: '2026-05-19T18:00:00+03:00',
  }),
})

const { success, data } = await res.json()

Поля ответа

URL карточки задачи в Битрикс24 строится из id и ID сотрудника:

https://<portal>.bitrix24.ru/company/personal/user/<responsibleId>/tasks/task/view/<id>/

<responsibleId> — ID ответственного (поле responsibleId в ответе): задача откроется в его личном кабинете. Сегмент user/<...> задаёт, в чьём кабинете отображается страница задач — подставьте ID нужного сотрудника, например текущего. <portal> — домен портала. Доступ ограничен правами сотрудника в Битрикс24.

Пример ответа

{
  "success": true,
  "data": {
    "id": 3871,
    "title": "Подготовить отчёт за квартал",
    "description": "",
    "status": 2,
    "priority": 2,
    "responsibleId": 1,
    "createdBy": 1,
    "createdDate": "2026-05-12T08:46:12.000Z",
    "deadline": "2026-05-19T15:00:00.000Z",
    "groupId": 0,
    "accomplices": [],
    "auditors": [],
    "creator": {
      "id": "1",
      "name": "Текущий пользователь",
      "link": "/company/personal/user/1/"
    },
    "responsible": {
      "id": "1",
      "name": "Текущий пользователь",
      "link": "/company/personal/user/1/"
    }
  }
}

Пример ответа при ошибке

422 — не указан ответственный:

{
  "success": false,
  "error": {
    "code": "BITRIX_ERROR",
    "message": "Не указан исполнитель"
  }
}

Ошибки

Полный список общих ошибок API — Ошибки.

Смотрите также

• Поля задачи
• Получить задачу
• Обновить задачу
• Список задач
• Загрузить файл
• Batch
• Лимиты и оптимизация