v56

OpenAPI 3.1.0raw.githubusercontent.com2026-08-043240557.2 KB
Agents

Update an agent's runtime harness and default model

Updates agents.harness_provider and upserts agent-scoped swarm_config rows for HARNESS_PROVIDER, MODEL_OVERRIDE, and REASONING_EFFORT_OVERRIDE. The settings apply to future provider sessions. For model and reasoning_effort: omit the field to leave it unchanged, send null to clear the corresponding override, or send a value to set it.

patch/api/agents/{id}/runtime

Path parameters

idstring required

Request body

harness_provider'claude' | 'codex' | 'pi' | 'opencode' required
modelstring nullable
allow_custom_modelboolean
reasoning_effort'off' | 'low' | 'medium' | 'high' | 'xhigh' | 'max' | 'null' nullable

Response

Updated agent row