Skip to main content
PATCH
Update agent profile

Authorizations

Authorization
string
header
required

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

Path Parameters

profileID
string<uuid>
required

Body

application/json
agent_type
enum<string>

The agent harness that runs a task, a profile or a connection: claude-code is Claude Code, codex is Codex, opencode is OpenCode.

Available options:
codex,
claude-code,
opencode
fallback
object

What a task continues on when its plan's window is spent: none stops it; named takes the connection or Aether inference; any_usable takes the first held connection the window does not block, then its optional named hop.

model
string
Minimum string length: 1
name
string
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: absent keeps the profile's pin; default pins nobody, so each task runs on its creator's default; aether, Aether inference (Claude Code and Codex only); stored, a connection by id, which you hold or the profile already pins, that works with the profile's agent.

Response

OK

agent_type
enum<string>
required

The agent harness that runs a task, a profile or a connection: claude-code is Claude Code, codex is Codex, opencode is OpenCode.

Available options:
codex,
claude-code,
opencode
created_at
string<date-time>
required
fallback
object
required

What a task continues on when its plan's window is spent: none stops it; named takes the connection or Aether inference; any_usable takes the first held connection the window does not block, then its optional named hop. A stored named hop without connection_id was disconnected.

id
string<uuid>
required
model
string
required
Minimum string length: 1
name
string
required
Required string length: 1 - 100
reasoning_effort
enum<string> | null
required
Available options:
ultra,
max,
xhigh,
high,
medium,
low,
ultrathink,
ultracode
runs_on
object
required

What the profile's tasks run on: default pins nobody, so each task runs on its creator's default; aether, Aether inference; stored, the connection it pins.

updated_at
string<date-time>
required