session_complete
tools/call
Complete or cancel the current agent session. When completing after receiving human instructions, include every processed instruction ID; explicit acknowledgements prevent completion while any instruction is still waiting. Older clients may omit this field, and any remaining instructions will close visibly as unacknowledged.
Scopes
complete:agent_sessions
Inputs
- sessionIdstringRequired
- Session ID
- status"completed" | "canceled"
- summarystring
- Completion summary
- acknowledgedInstructionIdsstring[]
- Every pending human instruction ID received and processed by this agent.
- requestReviewboolean
- Ask a person to review this work when completing. Leave it off when nothing needs a person's check; sessions are never put in review otherwise.
- idempotencyKeystringRequired
- Unique retry key
Returns
The completed or cancelled session. A call returns content[0].text with the JSON result and structuredContent.result with the same value.
Listed when
The key has agent access.