Skip to main content
POST

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json

Request to create an agent.

config
AgentCreationConfig · object

The configuration for the agent creation request.

id
string

Unique identifier of the request.

created_at
string<date-time>

Date and time when the request was created (in UTC timezone)

callback_url
string<uri> | null

The URL to call when the request is completed.

Minimum string length: 1
model
enum<string> | null

VLM Run Agent model to use for agent creation. When omitted, the skill's vlmrun.yaml model is used; otherwise the agent default.

Available options:
vlmrun-orion-1,
vlmrun-orion-1:lite,
vlmrun-orion-1:auto,
vlmrun-orion-1:fast,
vlmrun-orion-1:pro,
vlmrun-orion-2,
vlmrun-orion-2:lite,
vlmrun-orion-2:auto,
vlmrun-orion-2:qwen3.6-35b-a3b,
vlmrun-orion-2:gemma4-26b-a4b,
vlmrun-orion-2:kimi-2.6,
vlmrun-orion-2:gpt-5.5,
vlmrun-orion-2:opus-4.8,
vlmrun-orion-2:muse-spark-1.1,
vlmrun-orion-2:grok-4.5,
vlmrun-orion-2:gemini-flash-3.5,
vlmrun-orion-2:fast,
vlmrun-orion-2:pro
name
string | null

Name of the agent. If not provided, a pretty-name will be generated.

inputs
AgentExecutionInputs · object | null

The inputs to the agent.

Response

Successful Response

Response to the agent creation request.

id
string
required

ID of the agent

name
string
required

Name of the agent

created_at
string<date-time>
required

Date and time when the agent was created (in UTC timezone)

updated_at
string<date-time>
required

Date and time when the agent was updated (in UTC timezone)

status
enum<string>
default:pending

The status of the job.

Available options:
pending,
enqueued,
running,
completed,
failed,
paused