---
title: "List Agent Sessions"
method: GET
path: "/ai/agent_sessions"
tags: ["AI"]
---

# List Agent Sessions

`GET /ai/agent_sessions`

## Query parameters

- `limit` integer
- `offset` integer
- `search` string
- `archived` boolean

## Response `200`

OK

- ListResponseBodyAgentSession
  - `$schema` string, uri — A URL to the JSON Schema for this object.
  - `data` AgentSession[], required
    - `attributes` AgentSessionAttributes, required
      - `agentName` string, required
      - `createdAt` string, date-time, required
      - `initialTurn` AgentTurn
        - `attributes` AgentTurnAttributes, required
          - `createdAt` string, date-time, required
          - `error` AgentTurnError
            - `code` string, required
            - `message` string, required
          - `finishReason` string
          - `finishedAt` string, date-time
          - `knowledgeCitations` AgentTurnKnowledgeCitation[]
            - `attributes` AgentTurnKnowledgeCitationAttributes, required
              - …
            - `id` string, required
          - `parentTurnId` string
          - `startedAt` string, date-time
          - `state` SessionStateRawMessage
            - `artifacts` Artifact[]
              - …
            - `custom` unknown
            - `messages` Message[]
              - …
            - `sessionId` string
          - `status` string, required
          - `updatedAt` string, date-time, required
        - `id` string, required
      - `latestTurn` AgentTurn
        - `attributes` AgentTurnAttributes, required
          - `createdAt` string, date-time, required
          - `error` AgentTurnError
            - `code` string, required
            - `message` string, required
          - `finishReason` string
          - `finishedAt` string, date-time
          - `knowledgeCitations` AgentTurnKnowledgeCitation[]
            - `attributes` AgentTurnKnowledgeCitationAttributes, required
              - …
            - `id` string, required
          - `parentTurnId` string
          - `startedAt` string, date-time
          - `state` SessionStateRawMessage
            - `artifacts` Artifact[]
              - …
            - `custom` unknown
            - `messages` Message[]
              - …
            - `sessionId` string
          - `status` string, required
          - `updatedAt` string, date-time, required
        - `id` string, required
      - `ownerUserId` string
      - `permissionScopes` string[], required
    - `id` string, required
  - `pagination` ResponsePagination, required
    - `next` string
    - `previous` string
    - `total` integer, required

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found
- `422` — Unprocessable Entity
- `500` — Internal Server Error

---

[API](https://skmtc.net/rezible/apis/rezible-api.md) · [All operations](https://skmtc.net/rezible/apis/rezible-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/rezible/rezible-api/versions/d226beeef0bf/schema)