resolve_agent_approval

POST

/v1/agent/approvals/{approval_id}

curl --request POST \
  --url https://example.com/v1/agent/approvals/example \
  --header 'Content-Type: application/json' \
  --data '{ "decision": "approve", "message": "example", "remember_for_session": true }'

Parameters

Path Parameters

approval_id

required

string

Approval ID from the approval-required SSE event

Request Body ^required

Media type application/json

Decision payload for a pending agentic tool approval.

object

decision

required

string

Allowed values: approve deny

message

Optional note passed back to the model on denial.

string | null

remember_for_session

Auto-approve all later tool calls in the same session.

boolean

Responses

200

Decision applied or queued

Media type application/json

object

status

required

“resolved”, “queued”, or “not_found”.

string

Example ^generated

{
  "status": "example"
}

404

Unknown approval ID

Media type application/json

object

status

required

“resolved”, “queued”, or “not_found”.

string

Example ^generated

{
  "status": "example"
}