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"

Authorizations

​
Authorization
string
header
required

Organization API key passed as a Bearer token. This is the scheme used by the public SDK surface.

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
read-only
​
name
string
required
read-only
​
version_name
string
required

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

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

Get engine_class_id from base_agent.

​
engine_name
string
required
read-only

Engine Display Name

​
input_definitions
object[]
required

List of input definitions for this agent version.

​
engine_config
any
required

Engine configuration.

​
organization_id
string<uuid>
required
read-only

Organization ID from base_agent.

​
readonly
boolean
required
read-only
​
base_agent
object
required

Serializer for BaseAgent (agent config)

​
creator
object | null
​
description
string

Description of the agent version.