Agent

Start an agent session

post/api/agent/sessions

Request

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

Request body

agentstring required
agent_namestring
goalstring
workspacestring
projectstring
rolestring
parent_session_idinteger

Chains a resume session to the run it continues.

metadataobject

Response

Created 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.