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.

Request body

agentSessionIdstring

Native agent session identifier used to resume its transcript.

conversationCheckpointOrigin'human' | 'coordination'

Whether the main-turn boundary came from a human or AO coordination.

coordinationIdstring

Opaque identity of an AO-authored semantic prompt accepted by the native agent.

eventstring

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

latestAssistantUpdatestring

Latest assistant update exposed by the provider hook.

latestUserPromptstring

Latest real user prompt exposed by the provider hook.

launchIdstring

AO process generation that produced the signal.

observedAtstring date-time

Time the local hook process observed the event, before delivery to the daemon.

providerTurnIdstring

Native main-turn identity reported by the hook, when supported.

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

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

submissionIdstring

AO prompt-hook context correlation UUID, when supported.

toolNamestring

Native tool name, for tool-use hook events.

toolUseIdstring

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

transcriptPathstring

Read-only provider-native transcript path exposed by the hook.

Response

okboolean required

sessionIdstring required

statestring required

Changes

Changed in 11 of the 169 revisions of this API.2421

Sep 23, 2026c9673ebc394b1See the full diff
- ○
  added the new optional request property
  new-optional-request-property
Sep 16, 20267e89f751104a1See the full diff
- ○
  added the new optional request property
  new-optional-request-property
Sep 14, 2026fe5d127437ea3See the full diff
- ○
  added the new optional request property
  new-optional-request-property
- ○
  added the new optional request property
  new-optional-request-property
- ○
  added the new optional request property
  new-optional-request-property
Sep 3, 2026d31a2d019c474See the full diff
- ○
  added the optional property to the response with the status
  response-optional-property-added
- ○
  added the optional property to the response with the status
  response-optional-property-added
- ○
  added the optional property to the response with the status
  response-optional-property-added
- ○
  added the optional property to the response with the status
  response-optional-property-added
Aug 28, 2026e853ada076ff1See the full diff
- ○
  added the new optional request property /
  new-optional-request-property
This revision also has 4 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog
Aug 9, 2026641f372d664d3See the full diff
- ○
  added the new optional request property
  new-optional-request-property
- ○
  added the new optional request property
  new-optional-request-property
- ○
  added the new optional request property
  new-optional-request-property
Aug 6, 2026966e7144cdbc1See the full diff
- ○
  added the new optional request property
  new-optional-request-property
Jul 24, 2026d202268a973f1See the full diff
- ○
  added the new optional request property
  new-optional-request-property
Jul 16, 20267a49ff91f2db2See the full diff
- ○
  added the new optional request property
  new-optional-request-property
- ○
  the request property became optional
  request-property-became-optional
Jul 11, 2026ff644229050b4See the full diff
- ○
  added the new optional request property
  new-optional-request-property
- ○
  added the new optional request property
  new-optional-request-property
- ○
  added the new optional request property
  new-optional-request-property
- ○
  added the new blocked enum value to the request property
  request-property-enum-value-added

Full history (11 revisions)