GET
/
v1
/
agents
/
{agent_id}
/
versions
/
current
/
Retrieve the current version of an agent.
curl --request GET \
  --url https://api.roe-ai.com/v1/agents/{agent_id}/versions/current/ \
  --header 'Authorization: Bearer <token>'
{
  "id": "456e7890-e89b-12d3-a456-426614174001",
  "name": "My Agent",
  "version_name": "version 2",
  "creator": {
    "id": 2,
    "email": "user@example.com",
    "first_name": "John",
    "last_name": "Doe"
  },
  "created_at": "2024-01-15T10:30:00Z",
  "description": "Current version of the agent",
  "engine_class_id": "TextExtractionEngine",
  "input_definitions": [
    {
      "key": "text",
      "data_type": "text/plain",
      "description": "Text to be processed",
      "accepts_multiple_files": null
    }
  ],
  "engine_config": {
    "text": "${text}",
    "model": "gpt-4.1-2025-04-14",
    "instruction": "Process the text",
    "temperature": "0.0",
    "output_schema": "{\"type\":\"string\",\"description\":\"The result\"}",
    "reasoning_effort": "medium"
  },
  "organization": "f3268066-4185-4353-8e0d-8089c759610c",
  "readonly": false,
  "base_agent": {
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "creator": {
      "id": 2,
      "email": "user@example.com",
      "first_name": "John",
      "last_name": "Doe"
    },
    "created_at": "2024-01-15T10:30:00Z",
    "name": "My Agent",
    "disable_cache": false,
    "cache_failed_jobs": false,
    "organization": "f3268066-4185-4353-8e0d-8089c759610c",
    "engine_class_id": "TextExtractionEngine",
    "current_version_id": "456e7890-e89b-12d3-a456-426614174001",
    "engine_name": "Text Insights"
  },
  "engine_name": "Text Insights"
}

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

get_supports_eval
boolean

Include information on whether the agent engine supports evaluation.

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 current agent version details.

Serializer for Agent (version) model

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.