View agent execution sessions with timing, cost, and observability data.
https://catalyst-usw.agentuity.cloudAuthentication
All requests require a Bearer token. Pass your SDK key in the Authorization header.
| Header | Value |
|---|---|
Authorization | Bearer YOUR_SDK_KEY |
You can find your SDK key in the Agentuity Console under your project settings.
List Sessions
List sessions with optional filtering, sorting, and pagination.
GET
/sessionhttps://catalyst-usw.agentuity.cloud/sessionParameters
query
| Name | Type | Required | Description |
|---|---|---|---|
limit | number | No | Max results, default 10 |
offset | number | No | Pagination offset |
sort | string | No | \`created\`, \`updated\`, \`duration\`, or \`startTime\` |
direction | string | No | \`asc\` or \`desc\` |
orgId | string | No | Filter by organization ID |
projectId | string | No | Filter by project ID |
deploymentId | string | No | Filter by deployment ID |
trigger | string | No | \`agent\`, \`api\`, \`email\`, \`sms\`, \`cron\`, \`manual\`, \`discord\`, or \`websocket\` |
env | string | No | Filter by environment |
devmode | boolean | No | Filter by devmode status |
success | boolean | No | Filter by success status |
threadId | string | No | Filter by thread ID |
agentIdentifier | string | No | Filter by agent identifier |
startAfter | string | No | ISO 8601 start-after filter |
startBefore | string | No | ISO 8601 start-before filter |
metadata | string | No | JSON-serialized filter |
Response
Returns sessions matching the specified filters.
| Status | Description |
|---|---|
| 200 | Sessions returned |
| 401 | Unauthorized — invalid or missing API key |
Response Fields
| Field | Type | Description |
|---|---|---|
id | string | the session id |
created_at | string | the creation timestamp |
updated_at | string | the last update timestamp |
deleted | boolean | whether the session is deleted |
deleted_at | string | null | the deletion timestamp |
deleted_by | string | null | who deleted the session |
start_time | string | the session start time |
end_time | string | null | the session end time |
duration | number | null | the session duration in nanoseconds |
org_id | string | the organization id |
project_id | string | the project id |
deployment_id | string | the deployment id |
agent_ids | string[] | the agent ids involved |
trigger | string | how the session was triggered |
env | string | the environment |
devmode | boolean | whether dev mode was enabled |
pending | boolean | whether the session is pending |
success | boolean | whether the session succeeded |
error | string | null | the error message if failed |
metadata | object | null | unencrypted key-value metadata (optional) |
cpu_time | number | null | the CPU time in nanoseconds |
llm_cost | number | null | the LLM cost |
llm_prompt_token_count | number | null | the LLM prompt token count |
llm_completion_token_count | number | null | the LLM completion token count |
total_cost | number | null | the total cost |
method | string | null | the HTTP method |
url | string | null | the request URL |
route_id | string | null | the route id |
thread_id | string | null | the thread id |
timeline | any | null | the session timeline tree (optional) |
user_data | string | null | the user data as JSON (optional) |
Example
curl -X GET 'https://catalyst-usw.agentuity.cloud/session' \
-H 'Authorization: Bearer $AGENTUITY_SDK_KEY'Get Session
Retrieve a specific session with enriched data including agent info, eval runs, and route details.
GET
/session/{id}https://catalyst-usw.agentuity.cloud/session/{id}Parameters
path
| Name | Type | Required | Description |
|---|---|---|---|
id | string | Yes | Session ID |
Response
Returns the session with enriched data including agent info, eval runs, and route details.
| Status | Description |
|---|---|
| 200 | Session returned |
| 401 | Unauthorized — invalid or missing API key |
| 404 | Session not found |
Response Fields
| Field | Type | Description |
|---|---|---|
session | object | |
session.id | string | the session id |
session.created_at | string | the creation timestamp |
session.updated_at | string | the last update timestamp |
session.deleted | boolean | whether the session is deleted |
session.deleted_at | string | null | the deletion timestamp |
session.deleted_by | string | null | who deleted the session |
session.start_time | string | the session start time |
session.end_time | string | null | the session end time |
session.duration | number | null | the session duration in nanoseconds |
session.org_id | string | the organization id |
session.project_id | string | the project id |
session.deployment_id | string | the deployment id |
session.agent_ids | string[] | the agent ids involved |
session.trigger | string | how the session was triggered |
session.env | string | the environment |
session.devmode | boolean | whether dev mode was enabled |
session.pending | boolean | whether the session is pending |
session.success | boolean | whether the session succeeded |
session.error | string | null | the error message if failed |
session.metadata | object | null | unencrypted key-value metadata (optional) |
session.cpu_time | number | null | the CPU time in nanoseconds |
session.llm_cost | number | null | the LLM cost |
session.llm_prompt_token_count | number | null | the LLM prompt token count |
session.llm_completion_token_count | number | null | the LLM completion token count |
session.total_cost | number | null | the total cost |
session.method | string | null | the HTTP method |
session.url | string | null | the request URL |
session.route_id | string | null | the route id |
session.thread_id | string | null | the thread id |
session.timeline | any | null | the session timeline tree (optional) |
session.user_data | string | null | the user data as JSON (optional) |
agents | object[] | resolved agents |
agents[].name | string | agent name |
agents[].identifier | string | agent identifier |
eval_runs | object[] | eval runs for this session |
eval_runs[].id | string | eval run id |
eval_runs[].created_at | string | creation timestamp |
eval_runs[].eval_id | string | evaluation id |
eval_runs[].pending | boolean | pending status |
eval_runs[].success | boolean | success status |
eval_runs[].error | string | null | error message |
eval_runs[].result | object | null | result object |
route | object | null | route information |
Example
curl -X GET 'https://catalyst-usw.agentuity.cloud/session/ses_abc123' \
-H 'Authorization: Bearer $AGENTUITY_SDK_KEY'Logs
Get Session Logs
Retrieve log entries for a specific session.
GET
/cli/session/{id}/logshttps://catalyst-usw.agentuity.cloud/cli/session/{id}/logsParameters
path
| Name | Type | Required | Description |
|---|---|---|---|
id | string | Yes | Session ID |
Response
Returns log entries for the session.
| Status | Description |
|---|---|
| 200 | Logs returned |
| 401 | Unauthorized — invalid or missing API key |
| 404 | Session not found |
Response Fields
| Field | Type | Description |
|---|---|---|
body | string | the log body |
severity | string | the log severity |
timestamp | string | the log timestamp |
Notes
This endpoint uses the App API base URL (api.agentuity.com), not the regional Catalyst URL.
Example
curl -X GET 'https://catalyst-usw.agentuity.cloud/cli/session/ses_abc123/logs' \
-H 'Authorization: Bearer $AGENTUITY_SDK_KEY'