List agent revisions

List an agent’s revisions, newest first.

GET /api/v2/agents/{agent_name}/revisions

Python

from hai_agents import Client

client = Client()

revisions = client.agents.list_agent_revisions(agent_name="my-research-bot")
for revision in revisions.items:
    print(revision.number, revision.created_at, revision.message)

200

{
  "items": [
    {
      "number": 2,
      "created_at": "2026-10-16T09:12:44Z",
      "created_by": "5f0c2a8e-3b1d-4f6a-9c2e-7d8b1a4e6f30",
      "message": "Cite a source for every claim",
      "restored_from": null
    },
    {
      "number": 1,
      "created_at": "2026-10-14T15:03:10Z",
      "created_by": "5f0c2a8e-3b1d-4f6a-9c2e-7d8b1a4e6f30",
      "message": null,
      "restored_from": null
    }
  ],
  "page": 1,
  "total": 2
}

Behavior

Specs are not included. Read a revision with Retrieve and ?revision=N, or run it with "agent": "name:N".

Path parameters

agent_name · string · required

The agent’s name, for example my-research-bot or h/web-surfer-flash.

Query parameters

page · integer · default: "1"

Page number (1-based).

size · integer · default: "10"

Items per page. Maximum: 1000.

sort · string · default: "-number"

Sort order. Options: number, -number.

Response

200 with a page envelope whose items are revision objects.

number · integer

Revision number, from 1.

created_at · string

When the revision was written, ISO 8601.

created_by · string | null

UUID of the user who wrote it. null when unknown, and on h/ agents.

message · string | null

The message sent with the write, if any. A restore stores Restored from vN.

restored_from · integer | null

The revision this one was restored from. null for ordinary writes.

Python

from hai_agents import Client

client = Client()

revisions = client.agents.list_agent_revisions(agent_name="my-research-bot")
for revision in revisions.items:
    print(revision.number, revision.created_at, revision.message)

200

{
  "items": [
    {
      "number": 2,
      "created_at": "2026-10-16T09:12:44Z",
      "created_by": "5f0c2a8e-3b1d-4f6a-9c2e-7d8b1a4e6f30",
      "message": "Cite a source for every claim",
      "restored_from": null
    },
    {
      "number": 1,
      "created_at": "2026-10-14T15:03:10Z",
      "created_by": "5f0c2a8e-3b1d-4f6a-9c2e-7d8b1a4e6f30",
      "message": null,
      "restored_from": null
    }
  ],
  "page": 1,
  "total": 2
}

Errors

Status	Cause
404	Not found, or not in your organization.