Sign in
OpenAPI 3.1.0raw.githubusercontent.com2026-08-21351711.3 MB

58c398ac0d1b

Agents

Update agent profile (role, description, capabilities, etc.)

put/api/agents/{id}/profile

Path parameters

idstring required

Request body

rolestring
descriptionstring
capabilitiesstring[]
claudeMdstring
soulMdstring
identityMdstring
setupScriptstring
toolsMdstring
heartbeatMdstring
changeSourcestring
changedByAgentIdstring
changeReasonstring

Response

Profile updated

idstring required
namestring required
isLeadboolean
status'idle' | 'busy' | 'offline' | 'waiting_for_credentials' required
descriptionstring
rolestring
capabilitiesstring[]
claudeMdstring
soulMdstring
identityMdstring
setupScriptstring
toolsMdstring
heartbeatMdstring
maxTasksinteger
emptyPollCountinteger
lastActivityAtstring date-time
provider'claude' | 'codex' | 'pi' | 'devin' | 'claude-managed' | 'opencode'
harnessProvider'claude' | 'codex' | 'pi' | 'devin' | 'claude-managed' | 'opencode' | 'null' nullable
credentialMissingstring[] nullable
createdAtstring date-time required
lastUpdatedAtstring date-time required