Sign in

v53

OpenAPI 3.1.0raw.githubusercontent.com2026-08-0363105115.0 KB
sessions

Report an agent activity-state signal for a session

post/api/v1/sessions/{sessionId}/activity

Path parameters

sessionIdstring required

Session identifier, e.g. project-1.

Session identifier, e.g. project-1.

Request body

agentSessionIdstring

Native agent session identifier used to resume its transcript.

eventstring

AO hook sub-command that produced this state (e.g. post-tool-use).

launchIdstring

AO process generation that produced the signal.

state'active' | 'idle' | 'waiting_input' | 'blocked' | 'exited'

Agent activity state reported by an agent hook. Optional for metadata-only hooks.

toolNamestring

Native tool name, for tool-use hook events.

toolUseIdstring

Native tool-use id, for tool-use hook events.

Response

OK

okboolean required
sessionIdstring required
statestring required