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"
}{}{
"detail": "<string>"
}{
"detail": "<string>"
}Create Agent Version
Create a new version of an existing agent.
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"
}{}{
"detail": "<string>"
}{
"detail": "<string>"
}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
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
Organization ID. This is required for access control. It can be provided via query or request body depending on the endpoint.
Body
Serializer for creating new agent versions
Version name for the agent version. Defaults to 'unnamed version' if not provided.
1Description for the agent version.
List of input definitions for this agent version.
Engine configuration as a dictionary of string key-value pairs.
Connector write actions for this version. Omitted: the new version keeps the current version's actions. A list: those become the new version's actions. []: the new version has none.
Show child attributes
Show child attributes
Response
Successfully created new agent version.
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.