Apply a previewed settings change
POST
/v1/organisations/{id}/environments/{envId}/settings/changes/{changeId}/applyOperation settings.apply · since 2026-11-05 · stable
Needs a session withwritescopeAnswers200 OK
{ "ok": true, "appliesNow" }.
Applying twice is refused with not_previewed: the change is already on its way.
Path parameters
- idstring (uuid)required
- The organisation id.
- envIdstring (uuid)required
- The environment id.
- changeIdstringrequired
- The previewed change, from settings.preview.
Body (JSON)
- monthlynumber or nulloptional
- The monthly price you accept, to the cent, when the change raises what the environment may cost (owners).
Errors
Every error is { "error", "message", "detail"? } (Errors and references). Besides the codes any route can answer, this one refuses with:
- change_not_found
- not_previewed
- preview_expired
- price_mismatch
- not_approver
- wrong_state
- busy
- limit_spend
- suspended
POST/v1/organisations/{id}/environments/{envId}/settings/changes/{changeId}/apply
curl -X POST "https://api.rykloud.com/v1/organisations/$ORG_ID/environments/$ENV_ID/settings/changes/$CHANGE_ID/apply" \
-H "Authorization: Bearer $RYKLOUD_TOKEN"