Skip to navigation
Workspace APIWorkspace Sessions

Complete a human task raised by a turn

View as Markdown

Completes a human task, optionally with a note and files. Every id in fileIds must exist and be readable by the caller (space:read on the space it lives in), otherwise 404 — a task result the agent cannot open is not a result. Authorization: work_session:comment on the session, OR space:contribute on one of its linked spaces; a desk session is writable only by its owner. Any denial is 404.

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Path parameters

sessionIdstringRequired
taskIdstringRequired

Query parameters

turnIdstringOptional1-128 characters

Request

This endpoint expects an object.
notestringOptional<=2000 characters
fileIdslist of stringsOptional

Response

The engine’s own result for the turn.

dataobject

Errors

400
Bad Request Error
404
Not Found Error
409
Conflict Error