Skip to main content
POST
Restore external database backup

Authorizations

Authorization
string
header
required

API key authentication. Pass your API key as a Bearer token in the Authorization header.

Path Parameters

id
string<uuid>
required

Database identifier

Pattern: ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$
Example:

"fb5e5168-4281-4bec-94c5-0d1584e9e657"

backup_id
string
required

External backup identifier from the backup list

Example:

"20250115-013000_manual_pg17_my-backup.sql.gz"

Body

application/json
target_database_id
string<uuid>

Optional ID of a different database to restore the backup into. When provided, the backup is restored into this database instead of the source. The target must be in the same cluster and of the same database type as the source. Its current data will be replaced.

Pattern: ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$
Example:

"fb5e5168-4281-4bec-94c5-0d1584e9e657"

Response

Default Response

message
string
required

Confirmation message

Example:

"External database backup restore started"