---
title: "List agent versions"
method: GET
path: "/agents/{agentId}/versions"
tags: ["Agent Versions"]
---

# List agent versions

`GET /agents/{agentId}/versions`

## Request

- Base URL: `https://app.freyavoice.ai/api/v2`
- URL: `https://app.freyavoice.ai/api/v2/agents/{agentId}/versions`
- Auth: HTTP bearer

Returns version history for an agent with pagination.

## Path parameters

- `agentId` string, required: Agent ID

## Query parameters

- `workspaceId` string, uuid, required: Workspace ID
- `limit` integer: Maximum number of versions to return (1-100)
- `offset` integer: Number of versions to skip for pagination

## Response `200`

Agent versions with pagination

- object
  - `success` true, required
  - `data` object, required
    - `message` string, required
    - `result` object, required
      - `versions` object[], required
        - `id` string, uuid, required
        - `agentId` string, required
        - `workspaceId` string, uuid, required
        - `versionNumber` integer, required
        - `versionType` 'edit' | 'rollback'
        - `parentVersionId` string, uuid, nullable, required
        - `isActive` boolean, required
        - `createdBy` string, uuid, nullable, required
        - `createdAt` string, date-time, required
        - `configDiffSummary` object[], nullable, required
          - `section` string, required
          - `count` integer, required
      - `total` integer, required
      - `limit` integer, required
      - `offset` integer, required

## Other responses

- `400`: Validation error
- `401`: Missing or invalid token
- `404`: Agent not found
- `500`: Server error

---

[API](https://skmtc.dev/freyavoice/apis/freyavoice-api.md) - [All operations](https://skmtc.dev/freyavoice/apis/freyavoice-api/llms.txt) - [OpenAPI document](https://skmtc.dev/freyavoice/apis/freyavoice-api/revisions/153d120f0c73?raw)