Agent

Update a session (status/goal/metadata)

patch/api/agent/sessions/{id}

Request

  • Base URL: http://localhost:38200
  • URL: http://localhost:38200/api/agent/sessions/{id}
  • Auth: one of:
    • HTTP bearer
    • API key in cookie token

Path parameters

idinteger required

Request body

status'active' | 'paused' | 'completed' | 'stalled' | 'abandoned'
goalstring
metadataobject

Response

Updated session.

idinteger
tenantIdinteger
agentIdinteger
workspaceIdinteger nullable
projectIdinteger nullable
goalstring nullable
rolestring nullable

Inferred at boot from the matched goal node's owner_role.

status'active' | 'paused' | 'completed' | 'stalled' | 'abandoned'
parentSessionIdinteger nullable
lastCheckpointIdinteger nullable
handoffContextIdinteger nullable
metadataobject
startedAtstring date-time
endedAtstring date-time nullable

Changes

No recorded changes to this operation across all 1 revision of this API.