Skip to main content
PUT
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>
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: absent keeps the profile's pin; null pins nobody, so each task runs on its creator's default; Aether inference (Claude Code and Codex only); or a connection by id, which you hold or the profile already pins, that works with the profile's agent.

Response

OK

agent_profile
object
required