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

Результаты задач: REST 3.0

Четыре маршрута вызывают одноимённые методы Bitrix24 через REST 3.0 (/rest/api/). Нужен API-ключ со скоупом task или tasks и правом на запись. Ответ оборачивается в JSON вида { "success": true, "data": <результат Bitrix24> }; содержимое результата REST 3.0 не преобразуется. Ошибки проходят через стандартную оболочку /v1.

Метод и путь Метод Bitrix24 Тело JSON
POST /v1/task-results tasks.task.result.add { "fields": { "taskId": 17, "text": "Готово" } }
POST /v1/task-results/from-chat-message tasks.task.result.addfromchatmessage { "fields": { "messageId": 73 } }
PATCH /v1/task-results/:id tasks.task.result.update { "fields": { "text": "Уточнено" } }
DELETE /v1/task-results/:id tasks.task.result.delete тело не требуется

При создании поле fields.taskId задаёт ID задачи, а fields.text — текст результата. Создание из сообщения чата использует fields.messageId. Обновление и удаление принимают положительный целочисленный ID результата в пути, который передаётся в Bitrix24 как верхнеуровневый id. Обновление передаёт fields без преобразования; поле text требуется контроллером Bitrix24. Для добавления из чата вызывающий пользователь должен иметь доступ к сообщению, что проверяет Bitrix24.

При создании и обновлении data содержит объект item с DTO результата; при удалении data содержит объект result с true. Это форма ответа REST 3.0, а не старого семейства tasks.Task.Result.*. Маршрут списка в эту группу не входит.