Documentation menu
Agents

List all revisions of an agent

GET /api/v1/agents/{coordinator}/revisions

Retrieve all revisions of an agent (owner-only).

Path Format

  • /api/v1/agents/:coordinator/revisions

Access

Owner-only: the agent owner must belong to the authenticated organization.

Pagination

  • limit: Number of revisions to return (1-100, default 20).
  • cursor: Opaque cursor returned in pagination.nextCursor; omit it for the first page.
  • A non-null pagination.nextCursor indicates another page is available.

Parameters

path

NameTypeRequiredDescription
coordinatorstringrequiredIdentifies the coordinator agent by its canonical name. Applies to List all revisions of an agent.

query

NameTypeRequiredDescription
agentIdstringoptionalSelects the Project Agent by its stable identifier. Applies to List all revisions of an agent.
environmentIdstringoptionalSelects the active Project environment coordinate. Applies to List all revisions of an agent.
organizationIdstringoptionalSelects the authorization organization for a legacy System Agent. Required for sessions without Project Agent coordinates. Omit when addressing a Project Agent.
limitintegeroptionalSets the maximum number of resources returned in this page. Applies to List all revisions of an agent.
cursorstringoptionalOpaque cursor returned by the previous page; omit it to read the first page. Applies to List all revisions of an agent.

Responses

StatusDescriptionBody
200Response for status 200application/json — object — revisions: array<AgentRevision> (required); pagination: object (required)
400The request is malformed or cannot be processed.application/json — PublicApiError — error: object (required)
401Authentication failed. The Authorization header is missing, or the credential is invalid or expired.application/json — PublicApiError — error: object (required)
403Access denied. The authenticated user does not have permission to perform this action.application/json — PublicApiError — error: object (required)
404Resource not found.application/json — PublicApiError — error: object (required)
409Request conflicts with current state of the resource, including safe deployment conflict classifications.application/json — PublicApiError — error: object (required)
422Request validation failed. Check the request body, query parameters, or path parameters.application/json — PublicApiError — error: object (required)
429Too many requests.application/json — PublicApiError — error: object (required)
500The server could not complete the request.application/json — PublicApiError — error: object (required)
503Service temporarily unavailable (e.g. execution capacity exhausted). The response carries a Retry-After header; retry with backoff.application/json — PublicApiError — error: object (required)