Agents

Update an agent's runtime harness and default model

Changed on

Updates agents.harness_provider and agent-scoped runtime config. The settings apply to future provider sessions. For model, reasoning_effort, and claude.transport: omit the field to leave it unchanged, send null to clear the corresponding override, or send a value to set it. A model the model catalog does not list is a 400 unless allow_custom_model is true. A latest: alias is not accepted here (aliases resolve for a task's model and for MODEL_TIER_* values); reasoning_effort must be one the harness and model support. profile sets the agent's default model profile (same tri-state): it must exist and run on harness_provider, and it cannot be sent with model. Sending model, or changing the model or effort override by any path, clears the default profile.

patch/api/agents/{id}/runtime

Request

  • Base URL
    http://localhost:3013
  • URL
    http://localhost:3013/api/agents/{id}/runtime
  • Auth
    HTTP bearer

Path parameters

idstring required

Query parameters

repoIdstring

Request body

harness_provider'claude' | 'codex' | 'pi' | 'opencode' | 'acp' | 'dsh' | 'amp' | 'cursor' | 'grok' | 'fx' required
modelstring nullable
allow_custom_modelboolean
reasoning_effort'off' | 'low' | 'medium' | 'high' | 'xhigh' | 'max' | 'null' nullable
profilestring nullable

Response

Updated agent row

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

Changes

    • warning

      added the new fx enum value to the ////////// response property for the response status

    • warning

      added the new fx enum value to the //// response property for the response status

    • warning

      added the new fx enum value to the //// response property for the response status

    • info

      added the new fx enum value to the request property

    • info

      added the optional property //// to the response with the status