Skip to main content
GET
List an agent's saved versions

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

tenant
string
required

Tenant whose agents you are managing. Discover the tenants your credentials cover with listMyClaudiaProjects. A tenant your credentials do not cover is indistinguishable from one that does not exist.

id
string
required

Assistant to operate on, as returned by listAssistants (assistant_id field).

Query Parameters

role
enum<string>
required

Deployment the assistant lives in: supervisor (orchestrator agents) or react (specialist agents), plus qna for knowledge-base Q&A agents. Read them with that role; they are CREATED through proposeAssistantCreate as deployment: react with graphId: qna_agent, and the platform derives the qna role from the graph. listAssistants returns it as deployment_role on each row — pass that value back here verbatim.

Available options:
supervisor,
react,
qna
page
integer<int32>
default:0

Page index, counting from 0. Versions come newest first. Page with hasMore from the response. A negative value reads page 0.

size
integer<int32>
default:10

Page size, from 1 to 10: a value outside that range is clamped to it, and the response echoes the size applied.

Response

One page of versions, newest first.

One page of an agent's versions, newest first.

items
object[]
required

The versions on this page, newest first.

page
integer<int32>
required

Page index this page was read at.

Example:

0

size
integer<int32>
required

Page size actually applied (capped at 10).

Example:

10

hasMore
boolean
required

Whether another page follows.

Example:

true