Skip to main content
POST
Create agent profile

Authorizations

Authorization
string
header
required

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

Body

application/json
agent_type
enum<string>
required
Available options:
codex,
claude-code,
opencode
model
string
required
Minimum string length: 1
name
string
required
Required string length: 1 - 100
reasoning_effort
enum<string> | null
Available options:
ultra,
max,
xhigh,
high,
medium,
low,
ultrathink,
ultracode
runs_on
object

What the profile's tasks run on: null or absent pins nobody, so each task runs on its creator's default; Aether inference (Claude Code and Codex only); or a connection you hold that works with the profile's agent.

Response

Created

agent_profile
object
required