Skip to the page

Preview a rollback to a kept deploy

POST/v1/organisations/{id}/environments/{envId}/resources/{rid}/deploys/{did}/rollback

Operation services.rollback · since 2026-11-05 · stable

Needs a session withwritescopeAnswers200 OK

A previewed change; apply it with changes.apply.

Path parameters

idstring (uuid)required
The organisation id.
envIdstring (uuid)required
The environment id.
ridstringrequired
The service's id.
didstringrequired
The deploy to go back to.

Body

None. Send no body, or an empty JSON object.

Errors

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

POST/v1/organisations/{id}/environments/{envId}/resources/{rid}/deploys/{did}/rollback
curl -X POST "https://api.rykloud.com/v1/organisations/$ORG_ID/environments/$ENV_ID/resources/$RESOURCE_ID/deploys/$DEPLOY_ID/rollback" \
  -H "Authorization: Bearer $RYKLOUD_TOKEN"
With the rykloud CLI
rykloud services rollback SERVICE DEPLOY [flags]

Command reference: rykloud services rollback