# Результаты задач: 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.*. Маршрут списка в эту группу не входит.