Skip to main content
POST
/
v1
/
agents
/
{agent_id}
/
versions
/
curl --request POST \
  --url "https://api.roe-ai.com/v1/agents/YOUR_AGENT_ID/versions/" \
  --header "Authorization: Bearer YOUR_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
    "prompt": "New version prompt",
    "description": "Version description"
  }'

{
  "id": "789e1234-e89b-12d3-a456-426614174002",
  "version_name": "version 2",
  "description": "Updated version with new features",
  "input_definitions": [
    {
      "key": "input_text",
      "description": "Text to process",
      "data_type": "text/plain"
    }
  ],
  "engine_config": {
    "model": "gpt-4",
    "temperature": "0.5"
  },
  "created_at": "2024-01-16T14:20:00Z",
  "readonly": false,
  "engine_class_id": "openai_chat",
  "organization": "org-123e4567-e89b-12d3-a456-426614174000"
}
curl --request POST \
  --url "https://api.roe-ai.com/v1/agents/YOUR_AGENT_ID/versions/" \
  --header "Authorization: Bearer YOUR_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
    "prompt": "New version prompt",
    "description": "Version description"
  }'

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.

Body

application/json

Serializer for creating new agent versions

​
version_name
string

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

Minimum string length: 1
​
description
string | null

Description for the agent version.

​
input_definitions
any

List of input definitions for this agent version.

​
engine_config
any

Engine configuration as a dictionary of string key-value pairs.

Response

Successfully created new agent version.

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

Description of the agent version.