Create Agent

curl --request POST \ --url "https://api.roe-ai.com/v1/agents/?organization_id=YOUR_ORG_ID" \ --header "Authorization: Bearer YOUR_API_KEY" \ --header "Content-Type: application/json" \ --data '{ "name": "My New Agent", "description": "Agent description" }'

{ "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a", "created_at": "2023-11-07T05:31:56Z", "name": "<string>", "disable_cache": true, "cache_failed_jobs": true, "organization_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a", "engine_class_id": "<string>", "current_version_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a", "job_count": 123, "most_recent_job": "2023-11-07T05:31:56Z", "engine_name": "<string>", "tags": [ { "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a", "name": "<string>", "created_at": "2023-11-07T05:31:56Z", "creator": 123, "usage_count": 123 } ], "creator": { "id": 123, "email": "jsmith@example.com", "display_name": "<string>", "first_name": "<string>", "last_name": "<string>" } }

Authorizations

Authorization

string

header

required

Organization API key passed as a Bearer token. This is the scheme used by the public SDK surface.

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 base agents with proper JSON field handling

name

string

required

Name of the base agent.

Minimum string length: 1

engine_class_id

string

required

Engine class ID for the agent.

Minimum string length: 1

organization_id

string<uuid>

Optional. Ignored by the API — the organization is derived from the authenticated API key/token. Accepted for backwards compatibility.

version_name

string

Name of the first version.

Minimum string length: 1

description

string

Description of the first version.

Minimum string length: 1

input_definitions

any

Input definitions for the first version.

engine_config

any

Engine configuration for the first version.

Response

Successfully created agent.

Serializer for BaseAgent (agent config)

string<uuid>

required

read-only

created_at

string<date-time>

required

read-only

name

string

required

Required string length: 1 - 200

disable_cache

boolean

required

Whether to disable job cache fetching for this agent.

cache_failed_jobs

boolean

required

Whether to cache failed jobs for this agent.

organization_id

string<uuid>

required

Organization ID that owns this agent.

engine_class_id

string

required

Maximum string length: 200

current_version_id

string<uuid>

required

read-only

UUID of the current agent version.

job_count

integer | null

required

read-only

Served job count: cached baseline + live delta, annotated by the views as job_count. None when stats weren't fetched (the list can be requested with include_job_stats=false; use /agents/job-stats/).

most_recent_job

string<date-time> | null

required

read-only

engine_name

string

required

read-only

Engine Display Name

API Documentation

Agents

Database

Roe Datasets

Policies

Webhooks

Authorizations

Query Parameters

Body

Response