Skip to navigation

Decide an approval raised by a turn

View as Markdown

Approves or rejects an action a turn proposed, optionally with edited parameters. The platform executes; the agent never holds the credential (spec §11). Every decision writes an audit row. An EGRESS approval — a parked request to an approval: true host in the version’s network policy — is decided only by an approver the agent version declares (approvals.approvers; empty means any member who can write the session), and its card is editable: false, so editedParams is refused. 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
approvalIdstringRequired

Query parameters

turnIdstringOptional1-128 characters

Request

This endpoint expects an object.
decisionenumRequired
Allowed values:
notestringOptional<=4000 characters
editedParamsmap from strings to anyOptional
editsmap from strings to anyOptional

Response

The engine’s own result for the turn.

dataobject

Errors

400
Bad Request Error
403
Forbidden Error
404
Not Found Error
409
Conflict Error
422
Unprocessable Entity Error
503
Service Unavailable Error