Restore a database from an S3 backup

Enqueues a restore job that downloads the backup and runs `pg_restore` in the shared `athena-scheduler`/`athena-worker` background runtime. Returns `202 Accepted` with a `job_id`; poll `/admin/backups/jobs/{id}` for execution status.

Path Parameters

key*string

S3 object key for the backup (URL-encoded, may contain slashes).

Header Parameters

apikey*string

The static admin key configured as ATHENA_KEY_12. Authorization headers (Bearer <key>), X-API-Key, X-Athena-Key, or ?api_key= are also accepted.

Request Body

application/json

client_name?|

Logical client whose Postgres URI is the restore target.

pg_uri?|

Direct Postgres URI for restores that are not tied to a registered client.

timeout_seconds?|

Optional timeout in seconds (default 3600).

Formatint32

Response Body

`application/json`

curl -X POST "https://athena-cluster.com/admin/backups/string/restore" \  -H "apikey: string" \  -H "Content-Type: application/json" \  -d '{}'

{
  "status": "string",
  "message": "string",
  "data": {
    "job_id": 0,
    "key": "string",
    "client_name": "string",
    "status": "string"
  }
}

Empty