GET
/
v1
/
agents
/
{agent_id}
/
versions
/
List agent versions.
curl --request GET \
  --url https://api.roe-ai.com/v1/agents/{agent_id}/versions/ \
  --header 'Authorization: Bearer <token>'
[
  [
    {
      "id": "456e7890-e89b-12d3-a456-426614174001",
      "version_name": "version 1",
      "description": "Initial version",
      "input_definitions": [
        {
          "key": "input_text",
          "description": "Text to process",
          "data_type": "text/plain"
        }
      ],
      "engine_config": {
        "model": "gpt-4",
        "temperature": "0.7"
      },
      "created_at": "2024-01-15T10:30:00Z",
      "readonly": false
    }
  ]
]

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

​
agent_id
string<uuid>
required

A UUID string identifying the base agent.

Query Parameters

​
organization_id
string<uuid>

Organization ID. This is required for access control. It can be provided via query or request body depending on the endpoint.

Response

Successfully retrieved list of agent versions.

​
id
string<uuid>
required
​
name
string
required
​
version_name
string
required

Version name for the agent version. Defaults to 'unnamed version' if not provided.

​
created_at
string<date-time>
required
​
engine_class_id
string
required

Get engine_class_id from base_agent.

​
engine_name
string
required

Engine Display Name

​
input_definitions
object[]
required

List of input definitions for this agent version.

​
engine_config
object
required

Engine configuration as a dictionary of string key-value pairs.

​
organization_id
string<uuid>
required

Organization ID from base_agent.

​
readonly
boolean
required
​
base_agent
object
required

Serializer for BaseAgent (agent config)

​
creator
object
​
description
string

Description of the agent version.