Restore a database backup to a target environment

POST

/api/v3/organizations/{organisation}/applications/{application}/environments/{environment}/backups/{backupId}/restore-database

curl --request POST \
  --url https://dashboard.quantcdn.io/api/v3/organizations/test-org/applications/test-app/environments/staging/backups/quant-gov-dashboard-staging-2025-09-19T21-50-27-145Z/restore-database \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{ "backupId": "example", "acknowledgeDataloss": true }'

• QuantCDN Public Cloud
• QuantGov Cloud

Initiates an async restore of a database backup into the specified target environment. The backup may originate from a different environment of the same application (cross-env restore). Returns 202 with a restoreId for status polling.

Authorizations

• BearerAuth

Parameters

Path Parameters

organisation

required

string

The organisation ID

Example

test-org

application

required

string

The application ID

Example

test-app

environment

required

string

The TARGET environment ID to restore INTO

Example

staging

backupId

required

string

The backup ID to restore from

Example

quant-gov-dashboard-staging-2025-09-19T21-50-27-145Z

Request Body^required

Media typeapplication/json

object

backupId

required

The backup ID to restore (must match path param)

string

acknowledgeDataloss

required

Must be true to confirm existing data will be overwritten

boolean

Example

true

Responses

202

Restore operation initiated

Media typeapplication/json

object

restoreId

string

status

string

message

string

Example

{
  "restoreId": "restore-abc123",
  "status": "in_progress",
  "message": "Database restore initiated"
}

422

Validation error

Media typeapplication/json

object

message

string

errors

object

Example^generated

{
  "message": "example",
  "errors": {}
}