Для AI-агентов: markdown этой страницы — /docs-content/entities/tasks/get.md индекс документации — /llms.txt

Получить задачу

GET /v1/tasks/:id

Возвращает одну задачу со всеми полями. Дополнительно к полям списка приходят встроенные объекты постановщика и ответственного, чек-лист, разрешённые действия и расширенная информация о соисполнителях и наблюдателях.

Параметры

Параметр Тип Обяз. Описание
id (path) number да ID задачи

Примеры

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

Terminal 
curl "https://vibecode.bitrix24.tech/v1/tasks/289" \
  -H "X-Api-Key: YOUR_API_KEY"

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

Terminal 
curl "https://vibecode.bitrix24.tech/v1/tasks/289" \
  -H "X-Api-Key: YOUR_APP_KEY" \
  -H "Authorization: Bearer USER_SESSION_TOKEN"

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

javascript 
const res = await fetch('https://vibecode.bitrix24.tech/v1/tasks/289', {
  headers: {
    'X-Api-Key': 'YOUR_API_KEY',
  },
})

const { success, data } = await res.json()
console.log(data.title, '— статус:', data.status)

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

javascript 
const res = await fetch('https://vibecode.bitrix24.tech/v1/tasks/289', {
  headers: {
    'X-Api-Key': 'YOUR_APP_KEY',
    'Authorization': 'Bearer USER_SESSION_TOKEN',
  },
})

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

Поля ответа

Поле Тип Описание
success boolean Всегда true при успехе
data object Объект задачи. Базовые поля — см. Поля задачи. Дополнительные блоки описаны ниже

Дополнительные блоки одиночного ответа:

Поле Тип Описание
data.creator object Постановщик: { id, name, link, icon, workPosition }
data.responsible object Ответственный: тот же формат, что и creator
data.accomplicesData object[] Подробности по соисполнителям (тот же формат, что и creator)
data.auditorsData object[] Подробности по наблюдателям (тот же формат, что и creator)
data.action object Карта разрешённых действий (boolean): complete, start, pause, delegate, remove, edit, defer, changeDeadline, checklistAddItems и другие
data.checklist array Пункты чек-листа (пустой массив, если чек-лист не заполнен)
data.checkListTree object Дерево чек-листа с метаданными
data.newCommentsCount number Количество непрочитанных комментариев

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

JSON 
{
  "success": true,
  "data": {
    "id": 289,
    "title": "Подготовить отчёт за квартал",
    "description": "",
    "status": 2,
    "priority": 1,
    "groupId": 0,
    "responsibleId": 79,
    "createdBy": 99,
    "createdDate": "2026-05-12T06:11:18.000Z",
    "changedDate": "2026-05-12T06:11:18.000Z",
    "deadline": "2026-05-19T15:00:00.000Z",
    "accomplices": [],
    "auditors": [],
    "checklist": [],
    "creator": {
      "id": "99",
      "name": "Анна Соколова",
      "link": "/company/personal/user/99/",
      "icon": "https://example.bitrix24.ru/.../avatar.png",
      "workPosition": null
    },
    "responsible": {
      "id": "79",
      "name": "Дмитрий Орлов",
      "link": "/company/personal/user/79/",
      "icon": "/bitrix/images/tasks/default_avatar.png",
      "workPosition": null
    },
    "newCommentsCount": 0,
    "action": {
      "complete": true,
      "start": true,
      "delegate": true,
      "edit": true,
      "remove": true,
      "defer": true,
      "changeDeadline": true
    }
  }
}

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

404 — задача не найдена:

JSON 
{
  "success": false,
  "error": {
    "code": "ENTITY_NOT_FOUND",
    "message": "task 999999999 not found"
  }
}

Ошибки

HTTP Код Описание
404 ENTITY_NOT_FOUND Задача с таким ID не найдена
403 SCOPE_DENIED API-ключ не имеет скоупа tasks
401 TOKEN_MISSING API-ключ не имеет настроенных токенов
401 MISSING_API_KEY Не передан заголовок X-Api-Key

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

Известные особенности

Встроенные данные пользователей. Поля creator и responsible приходят вложенным объектом с именем, ссылкой на профиль и аватаркой. Отдельный GET /v1/users/:id для отображения автора задачи не требуется.

Приведение типов работает на верхнем уровне, внутрь объектов не заходит. Поля-карточки (creator, responsible, group, accomplicesData, auditorsData) объявлены объектами и приходят от Битрикс24 как есть — значения внутри них остаются в том виде, в каком их отдал портал, в том числе creator.id строкой ("99"). Это не то же самое, что верхнеуровневый createdBy, который приходит числом. Для арифметики по вложенному идентификатору приводите через Number().

Типы значений соответствуют схеме. Поля, объявленные в схеме числами, приходят числами — включая commentsCount, serviceCommentsCount и chatId, который раньше был строкой в списке и числом в карточке. Признаки «да/нет» приходят значениями true/false, пустые tags, group, accomplicesData, auditorsData — пустым объектом {}. Приведение через Number(value) больше не требуется.

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