Skip to the page

Apply a previewed change at its stated price

POST/v1/organisations/{id}/environments/{envId}/changes/{cid}/apply

Operation changes.apply · since 2026-11-05 · stable

Needs a session withwritescopeAnswers200 OK

The change, now approved and applying, or awaiting approval when it raises the price (an owner) or is in production with required approval (a second maintainer).

Applying twice is refused with wrong_state, and only the change's author applies it.

Path parameters

idstring (uuid)required
The organisation id.
envIdstring (uuid)required
The environment id.
cidstring (uuid)required
The previewed change, from changes.preview.

Body (JSON)

monthlynumberrequired
The monthly price after the change, as the preview stated it. A different price is refused (price_changed).

Errors

Every error is { "error", "message", "detail"? } (Errors and references). Besides the codes any route can answer, this one refuses with:

  • wrong_state
  • plan_stale
  • price_changed
  • limit_spend
  • not_allowed
POST/v1/organisations/{id}/environments/{envId}/changes/{cid}/apply
curl -X POST "https://api.rykloud.com/v1/organisations/$ORG_ID/environments/$ENV_ID/changes/$CHANGE_ID/apply" \
  -H "Authorization: Bearer $RYKLOUD_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "monthly": 12.5
}'
With the rykloud CLI
rykloud changes apply CHANGE [flags]

Command reference: rykloud changes apply