Restore a filesystem backup to a target environment

POST

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

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-filesystem \
  --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 filesystem 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. tar extraction overwrites same-named files in the target EFS in place; pre-existing files not in the archive are preserved.

boolean

Responses

202

Restore operation initiated

Media typeapplication/json

object

restoreId

string

status

string

message

string

Example

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

422

Validation error

Media typeapplication/json

object

message

string

errors

object

Example^generated

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