Docs
Sign in

Change install-wide settings.

Raising cloudBudgetCapUsd, maxVms or loadTestApprovalThreshold lets more be spent, so a key needs approve as well as config for that; lowering them needs only config.

PATCH/api/v1/settings

Scopeconfig

When an API key calls it, the timeline records who did what and the outcome. No path or query parameters.

Body.

cloudBudgetCapUsd0–10000

Hard cap on cloud compute for the whole install, in dollars.

maxVms0–100

The most cloud VMs open at once across every crew.

defaultVmTypeenum

The size of new cloud VMs. One of small, default, large.

agentsPerVm1–32

Agents each cloud VM runs. At most agentsPerVmMax.

agentsPerVmMax1–32

The ceiling on agentsPerVm.

defaultTimeoutMinutes1–1440

The time limit the dashboard's launch form starts with. The API does not use it: every launch sets limits.timeoutMinutes.

loadTestApprovalThreshold1–100

A crew whose agent cap is at or above this needs your approval (a load test) before it starts any cloud VM.

favoriteModelsarray

"<connectionId>:<modelId>"; trimmed and de-duplicated in order on save. At most 200 items.

Response.

200 OK: a JSON object. The example has placeholder values.

422 validation_failed
The body does not match its schema; each problem is in details.