v1
latestOpenAPI 3.1.02026-08-04151221521.2 KBAgents
List Versions for Agent
List all versions for an agent.
Optionally filter by branch name or version status.
Versions are ordered by deployed_at descending (most recent first).
get/agents/{namespace_slug}/{agent_name}/versions
Path parameters
namespace_slugstring required
agent_namestring required
Query parameters
branchstring nullable
Filter by branch name (e.g., 'main', 'feature/login'). If not provided, returns versions across all branches.
Filter by branch name (e.g., 'main', 'feature/login'). If not provided, returns versions across all branches.
status'DEPLOYING' | 'ACTIVE' | 'FAILED' | 'UNHEALTHY' | 'DRAINING' | 'RETIRED' | 'ROLLED_BACK'
Status of a version in its lifecycle.
Filter by version status
limitinteger
Maximum versions to return
Maximum versions to return
Response
Successful Response