Sessions
A session records one conversation an agent has, from start to end. Sessions created through the API appear alongside other sessions in the Admin app, where their transcript, tool calls, and metrics can be reviewed.
Create session
Start a session for the agent and return it under `data.session` with status `in_progress`. Every body field is optional, but a body is required, so send `{}` to use the defaults. `sessionId` is generated if omitted, and reusing an existing ID overwrites that session. Returns 201. Requires the `agentic-runtime-service:session:create` scope.
List sessions
List the agent's sessions, newest first, under `data.sessions`. Filter with the optional `type` (`live` or `evaluate`) and `status` (`in_progress` or `complete`) query parameters. Results are not paginated. Requires the `agentic-runtime-service:session:read` scope.
Get session
Retrieve a session under `data.session` and its transcript under `data.events`: turns (`type: message`), tool calls (`type: tool`), and events (`type: event`), oldest first. Returns 404 if the session does not belong to the agent. Requires the `agentic-runtime-service:session:read` scope.
Session Activity
4 items