Sign in
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).

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.

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.

transcriptPathstring

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

Response

OK

okboolean required
sessionIdstring required
statestring required

Changes

Changed in 7 of the 107 revisions of this API.2412

  • e853ada076ff1See the full diff
    • ○

      added the new optional request property usage/providerId

      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

  • 641f372d664d3See the full diff
    • ○

      added the new optional request property latestAssistantUpdate

      new-optional-request-property

    • ○

      added the new optional request property latestUserPrompt

      new-optional-request-property

    • ○

      added the new optional request property transcriptPath

      new-optional-request-property

  • 966e7144cdbc1See the full diff
    • ○

      added the new optional request property usage

      new-optional-request-property

  • d202268a973f1See the full diff
    • ○

      added the new optional request property launchId

      new-optional-request-property

  • 7a49ff91f2db2See the full diff
    • ○

      added the new optional request property agentSessionId

      new-optional-request-property

    • ○

      the request property state became optional

      request-property-became-optional

  • ff644229050b4See the full diff
    • ○

      added the new optional request property event

      new-optional-request-property

    • ○

      added the new optional request property toolName

      new-optional-request-property

    • ○

      added the new optional request property toolUseId

      new-optional-request-property

    • ○

      added the new blocked enum value to the request property state

      request-property-enum-value-added

  • b64f5ab46d8724See the full diff
    • ▲

      the request property state became required

      request-property-became-required

    • ▲

      removed the enum value blocked of the request property state

      request-property-enum-value-removed

    • ●

      removed the request property agentSessionId

      request-property-removed

    • ●

      removed the request property event

      request-property-removed

    • ●

      removed the request property toolName

      request-property-removed

    • ●

      removed the request property toolUseId

      request-property-removed

    This revision also has 37 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog