Sign in

v2

latestOpenAPI 3.1.02026-07-262937191.0 MB
beta.agents

List all versions of an agent.

Retrieve all versions for a specific agent with full agent context. Supports pagination.

get/v1/agents/{agent_id}/versions

Path parameters

agent_idstring required

Query parameters

pageinteger

Page number (0-indexed)

Page number (0-indexed)

page_sizeinteger

Number of versions per page

Number of versions per page

Response

Successful Response

instructionsstring nullable

Instruction prompt the model will follow during the conversation.

modelstring required
namestring required
descriptionstring nullable
handoffsstring[] nullable
metadataMetadataDict

Custom type for metadata with embedded validation.

object'agent'
idstring required
versioninteger required
versionsinteger[] required
created_atstring date-time required
updated_atstring date-time required
deployment_chatboolean required
sourcestring required
version_messagestring nullable

Example response

[
  {
    "completion_args": {
      "response_format": {
        "type": "text"
      }
    }
  }
]