Skip to main content
GET
/
v1
/
agents
/
{agent_id}
/
versions
curl --request GET \
  --url "https://api.roe-ai.com/v1/agents/YOUR_AGENT_ID/versions/?organization_id=YOUR_ORG_ID" \
  --header "Authorization: Bearer YOUR_API_KEY"

[
  [
    {
      "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
    }
  ]
]
curl --request GET \
  --url "https://api.roe-ai.com/v1/agents/YOUR_AGENT_ID/versions/?organization_id=YOUR_ORG_ID" \
  --header "Authorization: Bearer YOUR_API_KEY"

Path Parameters

​
agent_id
string<uuid>
required

A UUID string identifying the base agent.

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.