Models

Update a model profile

Changed on

Changes the model, effort, custom-model flag or description; the name and harness are fixed. Omit a field to keep it; effort: null clears it. Applies to tasks claimed after the change. Operator only (the shared API key).

patch/api/model-profiles/{name}

Request

  • Base URL
    http://localhost:3013
  • URL
    http://localhost:3013/api/model-profiles/{name}
  • Auth
    HTTP bearer

Path parameters

namestring required

Request body

modelstring
effort'off' | 'low' | 'medium' | 'high' | 'xhigh' | 'max' | 'null' nullable
allowCustomModelboolean
descriptionstring nullable

Response

Profile updated

idstring required
namestring required
harness'claude' | 'codex' | 'pi' | 'devin' | 'claude-managed' | 'opencode' | 'acp' | 'dsh' | 'amp' | 'cursor' | 'grok' | 'fx' required
modelstring required
effort'off' | 'low' | 'medium' | 'high' | 'xhigh' | 'max' | 'null' nullable required
allowCustomModelboolean required
descriptionstring nullable required
seededFromstring nullable required
createdAtstring required
lastUpdatedAtstring required

Changes