For AI agents: markdown of this page — /docs-content-en/entities/tasks/results-v3.md documentation index — /llms.txt
Task results: REST 3.0
These four routes call the corresponding Bitrix24 methods through REST 3.0 (/rest/api/). They require an API key with the task or tasks scope and write access. The response is wrapped as { "success": true, "data": }; the REST 3.0 result stays unchanged. Errors use the standard /v1 envelope.
| Method and path | Bitrix24 method | JSON body |
|---|---|---|
POST /v1/task-results |
tasks.task.result.add | { "fields": { "taskId": 17, "text": "Done" } } |
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": "Revised" } } |
DELETE /v1/task-results/:id |
tasks.task.result.delete | no body required |
For creation, fields.taskId is the task ID and fields.text is the result text. Creation from a chat message uses fields.messageId. Update and delete take a positive integer result ID in the path and send it to Bitrix24 as top-level id. Update forwards fields unchanged; the Bitrix24 controller requires text. For creation from a chat message, Bitrix24 checks the caller's access to that message.
For add and update, data contains an item object with the result DTO; for delete, data contains a result object with true. This is the REST 3.0 response shape, separate from the older tasks.Task.Result.* family. This group does not expose a list route.