---
title: "List Agent Turns"
method: GET
path: "/ai/agent_sessions/{id}/turns"
tags: ["AI"]
---

# List Agent Turns

`GET /ai/agent_sessions/{id}/turns`

## Path parameters

- `id` string, required

## Query parameters

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

## Response `200`

OK

- ListResponseBodyAgentTurn
  - `$schema` string, uri — A URL to the JSON Schema for this object.
  - `data` AgentTurn[], required
    - `attributes` AgentTurnAttributes, required
      - `createdAt` string, date-time, required
      - `error` AgentTurnError
        - `code` string, required
        - `message` string, required
      - `finishReason` string
      - `finishedAt` string, date-time
      - `sequence` integer, required
      - `startedAt` string, date-time
      - `status` string, required
      - `updatedAt` string, date-time, 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

## Changes

- **2026-08-18** (v1) `b05387ac4633` — 1 warning
  - removed the optional property `data/items/attributes/knowledgeCitations` from the response with the `200` status
- **2026-08-14** (v1) `dbc273b2bbef` — 2 warning, 1 info
  - removed the optional property `data/items/attributes/parentTurnId` from the response with the `200` status
  - removed the optional property `data/items/attributes/state` from the response with the `200` status
  - added the required property `data/items/attributes/sequence` to the response with the `200` status
- **2026-08-10** (v1) `4457b35521ad` — 2 warning, 1 info
  - removed the optional property `data/items/attributes/knowledgeCitations/items/attributes/knowledgeEntityId` from the response with the `200` status
  - removed the optional property `data/items/attributes/knowledgeCitations/items/attributes/knowledgeRelationshipId` from the response with the `200` status
  - the response property `data/items/attributes/knowledgeCitations/items/attributes/knowledgeEvidenceId` became required for the status `200`
- **2026-07-30** (v1) `d226beeef0bf` — 1 info
  - added the optional property `data/items/attributes/knowledgeCitations` to the response with the `200` status
- **2026-07-21** (v1) `ffea3af600ea` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/rezible/apis/rezible-api/changes/ai/agent_sessions/:id/turns/get.md)

---

[API](https://skmtc.dev/rezible/apis/rezible-api.md) · [All operations](https://skmtc.dev/rezible/apis/rezible-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/rezible/rezible-api/revisions/eaee3040e50d/schema)
