For AI agents: markdown of this page — /docs-content-en/entities/tasks/results.md documentation index — /llms.txt
Task results: legacy REST
These four routes call tasks.Task.Result.* through the legacy Bitrix24 REST transport. The API key needs the task (or tasks) scope. VibeCode makes one call and returns its result as data without changing the shape.
POST /v1/task-results/from-comment/:commentId
GET /v1/tasks/:taskId/results
GET /v1/tasks/:taskId/results/first
GET /v1/tasks/:taskId/results/last
| HTTP | Route | Bitrix24 method | Bitrix24 parameters |
|---|---|---|---|
POST |
/v1/task-results/from-comment/:commentId |
tasks.Task.Result.addFromComment |
commentId, optional params from the JSON body |
GET |
/v1/tasks/:taskId/results |
tasks.Task.Result.list |
taskId, optional params from the query |
GET |
/v1/tasks/:taskId/results/first |
tasks.Task.Result.getFirst |
taskId |
GET |
/v1/tasks/:taskId/results/last |
tasks.Task.Result.getLast |
taskId |
commentId and taskId must be positive integer IDs. For list, the optional query flags WITH_USER_INFO, WITH_PARSED_TEXT, and WITH_FILE_INFO accept Y or N and are sent to Bitrix24 inside params. For addFromComment, the optional body can be {"params":{"WITH_FILE_INFO":"Y"}}; only this flag is supported, and it is passed through unchanged.
addFromComment addresses legacy forum comments. It does not promise to work with the new task card. This route does not search task chat or call another method if Bitrix24 refuses the request. After an uncertain POST outcome, inspect task results before retrying.
Success has the shape { "success": true, "data": <Bitrix24 result> }. An empty list returns data: []. getFirst and getLast return Bitrix24's { "result": 0 } when there is no result; this is not a 404. addFromComment may return null. VibeCode does not rename the result object's fields.
Invalid IDs, flags, or bodies return 400 INVALID_PARAMS; a missing or invalid key returns 401; missing scope and a write attempt with a READONLY key return 403. Bitrix24 refusals use the standard /v1 handler and may return 422 BITRIX_ERROR, 429 RATE_LIMITED, 502 BITRIX_UNAVAILABLE, or 503 BITRIX_TIMEOUT.