---
title: "List all sessions"
method: GET
path: "/agent-session-manager/sessions"
tags: ["Agent Session Manager"]
---

# List all sessions

`GET /agent-session-manager/sessions`

## Request

- Base URL: `https://example.itential.io`
- URL: `https://example.itential.io/agent-session-manager/sessions`
- Auth: none declared

Lists all sessions.

## Query parameters

- `filters` unknown[]
  - unknown
- `offset` number, double
- `limit` number, double
- `sortBy` 'createdAt' | 'updatedAt' | 'startedAt' | 'endedAt' | 'status' | 'createdBy' | 'agentDefinitionId' | 'totalOutputTokens' | 'totalInputTokens' | 'totalTokens': Field to sort by
- `sortOrder` 'asc' | 'desc': Sort order

## Response `200`

result

- AgentSessionManagerGetSessionsResponse200
  - `data` AgentSessionManagerSessionsGetResponsesContentApplicationJsonSchemaDataItems[], required: Session data
    - `sessionId` string: The session ID assigned by AEE
    - `agentDefinitionId` string, required: The agent definition ID
    - `agentSnapshot` AgentSessionManagerSessionsGetResponsesContentApplicationJsonSchemaDataItemsAgentSnapshot: Snapshot of the agent configuration at session start time
      - `_id` string, required: Agent definition ID
      - `name` string, required: Agent name
      - `description` string, required: Agent description
      - `instructions` string, required: Agent instructions
      - `namespace` AgentSessionManagerSessionsGetResponsesContentApplicationJsonSchemaDataItemsAgentSnapshotNamespace: Parent project namespace info
        - `_id` string, required: Project UUID
        - `name` string, required: Project name
    - `status` 'PENDING' | 'RUNNING' | 'PAUSING' | 'PAUSED' | 'COMPLETE' | 'FAILED' | 'CANCELING' | 'CANCELED', required: Current session status
    - `startedAt` string, date-time: Session start timestamp (engine-authoritative)
    - `endTime` string, date-time: Session end timestamp
    - `duration` number, double: Session duration in milliseconds
    - `createdAt` string, date-time, required: Session creation timestamp
    - `createdBy` string, required: User who created the session
    - `provider` string: Infrastructure provider (e.g. aws, gcp)
    - `modelVersion` string: Model version used
    - `sessionType` 'root' | 'child': Session type
    - `trigger` AgentSessionManagerSessionsGetResponsesContentApplicationJsonSchemaDataItemsTrigger: Trigger context for trigger-fired sessions. source is the name of the firing user for manual triggers, or set as the name of the trigger for all other trigger types.
      - `type` 'eventSystem' | 'endpoint' | 'schedule' | 'manual' | 'job' | 'session', required: Trigger type that started the session
      - `name` string, required: Name of the trigger that fired the session
      - `source` string, required: For manual and API triggers, the username of the person who started the session. For schedule and event triggers, the name of the trigger.
    - `canceledBy` string: User who canceled the session
    - `errorMessage` string: Error message if session failed
    - `errorCategory` string: Error category if session failed
    - `durationMs` number, double: Session duration in milliseconds
    - `iterationCount` number, double: Number of inference iterations
    - `toolGroupCount` number, double: Number of tool groups dispatched
    - `totalToolCallCount` number, double: Total number of tool calls made
    - `totalInputTokens` number, double: Total input tokens consumed across all inferences
    - `totalOutputTokens` number, double: Total output tokens produced across all inferences
    - `totalTokens` number, double: Combined total tokens consumed across all inferences (input + output)
    - `inputs` AgentSessionManagerSessionsGetResponsesContentApplicationJsonSchemaDataItemsInputs: Inputs passed when starting the session
  - `total` number, double, required: Total number of sessions
  - `offset` number, double, required: Number of records skipped
  - `limit` number, double, required: Number of items per page

## Other responses

- `500`: Error response from API

## Changes

- **2026-10-31** `2095cc90e583`: 2 info
  - api tag `Agent Session Manager` added
  - api tag `agentSessionManager` removed

[Operation history](https://skmtc.dev/itential/apis/itential-2/changes/agent-session-manager/sessions/get.md)

---

[API](https://skmtc.dev/itential/apis/itential-2.md) - [All operations](https://skmtc.dev/itential/apis/itential-2/llms.txt) - [OpenAPI document](https://skmtc.dev/itential/apis/itential-2/revisions/2095cc90e583?raw)