Agents

Update provider-scoped settings without touching the saved credential. Today that means just `default_model`; future per-provider settings (base URL overrides, request headers, etc.) can land here too without changing the shape of `save_credential`.

patch/settings/ai-providers/{provider_id}

Request

  • Base URL: /api (relative, and the document was published on a file host, not at the API’s origin)
  • URL: /api/settings/ai-providers/{provider_id}
  • Auth: HTTP bearer

Path parameters

provider_idstring required

AI provider ID

Request body

default_modelstring nullable

New default model id. None or an empty string clears the stored value so the CLI falls back to its own default.

max_turns_analysisinteger nullable

Default max turns for the autofixer analysis phase (1–200). 0 clears the stored value (built-in default applies); omitted/None leaves the current value unchanged — so a PATCH that only updates default_model doesn't wipe the turn settings.

max_turns_feedbackinteger nullable

Default max turns for autofixer feedback rounds (1–200). 0 clears; omitted leaves unchanged.

max_turns_fixinteger nullable

Default max turns for the autofixer fix phase (1–200). 0 clears; omitted leaves unchanged.

Response

default_modelstring nullable
max_turns_analysisinteger nullable
max_turns_feedbackinteger nullable
max_turns_fixinteger nullable
provider_idstring required

Changes

No recorded changes to this operation across all 54 revisions of this API.