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": "MultimodalExtractionEngine",
"input_definitions": [
{
"key": "text",
"data_type": "text/plain",
"description": "Text to be processed",
"accepts_multiple_files": null
}
],
"engine_config": {
"text": "${text}",
"model": "gpt-5.5-2026-04-23",
"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": "MultimodalExtractionEngine",
"current_version_id": "456e7890-e89b-12d3-a456-426614174001",
"engine_name": "Multimodal Extraction"
},
"engine_name": "Multimodal Extraction"
}{
"detail": "<string>"
}{
"detail": "<string>"
}Retrieve Current Agent Version
Retrieve details of the current version of a specific agent.
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": "MultimodalExtractionEngine",
"input_definitions": [
{
"key": "text",
"data_type": "text/plain",
"description": "Text to be processed",
"accepts_multiple_files": null
}
],
"engine_config": {
"text": "${text}",
"model": "gpt-5.5-2026-04-23",
"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": "MultimodalExtractionEngine",
"current_version_id": "456e7890-e89b-12d3-a456-426614174001",
"engine_name": "Multimodal Extraction"
},
"engine_name": "Multimodal Extraction"
}{
"detail": "<string>"
}{
"detail": "<string>"
}curl --request GET \
--url "https://api.roe-ai.com/v1/agents/YOUR_AGENT_ID/versions/current/" \
--header "Authorization: Bearer YOUR_API_KEY"
Authorizations
Organization API key passed as a Bearer token. This is the scheme used by the public SDK surface.
Path Parameters
A UUID string identifying the base agent.
Query Parameters
Include information on whether the agent engine supports evaluation.
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
Version name for the agent version. Defaults to 'unnamed version' if not provided.
Get engine_class_id from base_agent.
Engine Display Name
True when this engine has a built-in memory profile, so memory profiles can be configured on it. Independent of whether memory is currently switched on.
List of input definitions for this agent version.
Show child attributes
Show child attributes
Engine configuration.
Connector write actions configured on this version.
Show child attributes
Show child attributes
Organization ID from base_agent.
Serializer for BaseAgent (agent config)
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Description of the agent version.