Skip to main content
GET
List Agent Versions

Overview

Returns version metadata for the agent’s dev timeline, or for one branch’s own saves when branch is set, ordered by created_at descending. Snapshots are omitted because they can be large; read one with Get Latest Agent Version or, for a published version, Get Agent Version.

Headers

string
required
Your API key for authentication.

Path Parameters

string
required
The agent’s unique identifier.

Query Parameters

integer
default:"50"
Maximum number of versions to return. Minimum 1, maximum 200. Values outside that range are clamped; a non-numeric value falls back to the default.
string
A branch ID. When set, only that branch’s own saves are listed (its base version is not included). When omitted, only dev-timeline versions are listed and branch saves are excluded. An unknown branch ID returns an empty array.

Response

array
Array of version metadata objects.
null | array
null on success, or a list of error objects if the request failed.

Docs for agents: llms.txt