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

{
  "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"
}

Documentation Index

Fetch the complete documentation index at: https://docs.roe-ai.com/llms.txt

Use this file to discover all available pages before exploring further.

curl --request GET \
  --url "https://api.roe-ai.com/v1/agents/YOUR_AGENT_ID/versions/current/" \
  --header "Authorization: Bearer YOUR_API_KEY"

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
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
​
description
string

Description of the agent version.