beta.agents

List all versions of an agent.

Changed on

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

get/v1/agents/{agent_id}/versions

Request

Path parameters

agent_idstring required

Query parameters

pageinteger

Page number (0-indexed)

page_sizeinteger

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
owner_idstring nullable
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"
      }
    }
  }
]

Changes

    • info

      added the optional property / to the response with the status

    • info

      added to the // response property anyOf list for the response status

    • info

      removed subschema #1 from the // response property anyOf list for the response status