---
title: "List an agent's revisions"
method: GET
path: "/agents/{agent_id}/revisions"
tags: ["Agents"]
---

# List an agent's revisions

`GET /agents/{agent_id}/revisions`

## Request

- Base URL: `https://api.axilio.ai/api/v1`
- URL: `https://api.axilio.ai/api/v1/agents/{agent_id}/revisions`
- Auth: API key in header `X-Axilio-Api-Key`
- TypeScript: <https://skmtc.dev/axilioai/apis/axilio-api-2/docs/agents/:agent_id/revisions/get.ts> (a function with typed inputs; its response is checked against the schema)

Lists an agent's revisions, newest first, one page at a time.

## Path parameters

- `agent_id` string, uuid, required: The agent's id.

## Query parameters

- `limit` integer: Page size.
- `offset` integer: Where the page starts.

## Response `200`

OK

- AgentRevisionList: One page of an agent's revisions, newest first, without their content.
  - `limit` integer, required: The page size.
  - `offset` integer, required: Where this page starts.
  - `revisions` AgentRevisionSummary[], nullable, required: The revisions on this page.
    - `agent_id` string, uuid, required: The agent the revision belongs to.
    - `author_user_id` string, uuid, nullable, required: The user who added the revision. Null once they have deleted their account.
    - `bytes` integer, required: The size of the revision's instructions or code, in bytes.
    - `created_at` string, date-time, required: When the revision was added.
    - `id` string, uuid, required: The revision's id.
    - `kind` 'code' | 'instructions', required: code: the revision is a script. instructions: the revision is a task the agent works through a model.
    - `message` string: The author's note on the revision.
    - `proposal_state` 'waiting' | 'superseded' | 'promoted': Set when the revision is a fix a repair proposed: waiting to be promoted, superseded, or promoted.
    - `revision` integer, required: The revision's number within the agent, from 1.
  - `total` integer, required: How many revisions the agent has.

## Other responses

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

## Changes

- **2026-11-02** `62aa324803a7`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/axilioai/apis/axilio-api-2/changes/agents/:agent_id/revisions/get.md)

---

[API](https://skmtc.dev/axilioai/apis/axilio-api-2.md) - [All operations](https://skmtc.dev/axilioai/apis/axilio-api-2/llms.txt) - [OpenAPI document](https://skmtc.dev/axilioai/apis/axilio-api-2/revisions/62aa324803a7?raw)