ITitential
Agent Session Manager

Update session state

Changed on

Updates the state of an agent session, such as canceling, pausing, or resuming it.

post/agent-session-manager/sessions/{sessionId}

Request

  • Base URL
    https://example.itential.io
  • URL
    https://example.itential.io/agent-session-manager/sessions/{sessionId}
  • Auth
    none declared

Path parameters

sessionIdstring required

sessionId

Request body

action'CANCEL' | 'PAUSE' | 'RESUME'

The action to perform on the session

canceledBystring

User performing the action

correlationIdstring

Correlation ID for request tracing.

Response

result

sessionIdstring

The session ID assigned by AEE

agentDefinitionIdstring required

The agent definition ID

status'PENDING' | 'RUNNING' | 'PAUSING' | 'PAUSED' | 'COMPLETE' | 'FAILED' | 'CANCELING' | 'CANCELED' required

Current session status

startedAtstring date-time

Session start timestamp (engine-authoritative)

endTimestring date-time

Session end timestamp

durationnumber double

Session duration in milliseconds

createdAtstring date-time required

Session creation timestamp

createdBystring required

User who created the session

providerstring

Infrastructure provider (e.g. aws, gcp)

modelVersionstring

Model version used

sessionType'root' | 'child'

Session type

canceledBystring

User who canceled the session

errorMessagestring

Error message if session failed

errorCategorystring

Error category if session failed

durationMsnumber double

Session duration in milliseconds

iterationCountnumber double

Number of inference iterations

toolGroupCountnumber double

Number of tool groups dispatched

totalToolCallCountnumber double

Total number of tool calls made

totalInputTokensnumber double

Total input tokens consumed across all inferences

totalOutputTokensnumber double

Total output tokens produced across all inferences

totalTokensnumber double

Combined total tokens consumed across all inferences (input + output)

inputsAgentSessionManagerSessionsSessionIdPostResponsesContentApplicationJsonSchemaInputs

Inputs passed when starting the session

Changes