Skip to the page

Apply a previewed settings change

POST/v1/organisations/{id}/environments/{envId}/settings/changes/{changeId}/apply

Operation 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"