Sign in

v8

latestOpenAPI 3.0.0Apache 2.0raw.githubusercontent.com2025-10-165266542.4 MB
DigitalOcean-public.v2-new_Apps

Validate App Rollback

Check whether an app can be rolled back to a specific deployment. This endpoint can also be used to check if there are any warnings or validation conditions that will cause the rollback to proceed under unideal circumstances. For example, if a component must be rebuilt as part of the rollback causing it to take longer than usual.

post/v2/apps/{app_id}/rollback/validate

Path parameters

app_idstring required

The app ID

Request body

deployment_idstring

The ID of the deployment to rollback to.

skip_pinboolean

Whether to skip pinning the rollback deployment. If false, the rollback deployment will be pinned and any new deployments including Auto Deploy on Push hooks will be disabled until the rollback is either manually committed or reverted via the CommitAppRollback or RevertAppRollback endpoints respectively. If true, the rollback will be immediately committed and the app will remain unpinned.

Example request

{
  "deployment_id": "3aa4d20e-5527-4c00-b496-601fbd22520a"
}

Response

A JSON object with the validation results.

validboolean

Indicates whether the app can be rolled back to the specified deployment.

Example response

{
  "error": {
    "code": "exceeded_revision_limit",
    "message": "the deployment is past the maximum historical revision limit of 0 for the \"starter\" app tier",
    "components": [
      "www"
    ]
  },
  "warnings": [
    {
      "code": "exceeded_revision_limit",
      "message": "the deployment is past the maximum historical revision limit of 0 for the \"starter\" app tier",
      "components": [
        "www"
      ]
    }
  ]
}