Athena
Backups

List or create database backups

Enqueues a backup job that runs `pg_dump` and uploads the archive to S3 in the shared `athena-scheduler`/`athena-worker` background runtime. Returns `202 Accepted` with a `job_id`; poll `/admin/backups/jobs/{id}` for execution status. Requires the static admin key (`ATHENA_KEY_12`) and S3 configuration (`ATHENA_BACKUP_S3_BUCKET`, `ATHENA_BACKUP_S3_PREFIX`, and credentials).

POST
/admin/backups

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 will be dumped.

pg_uri?|

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

label?|

Optional human-readable label stored in S3 object metadata.

timeout_seconds?|

Optional timeout in seconds (default 3600).

Formatint32
recovery_strategy?|

Optional pg_dump auto-recovery strategy for known catalog issues.

Value in"none" | "repair_missing_role_oids"

Response Body

application/json

curl -X POST "https://athena-cluster.com/admin/backups" \  -H "apikey: string" \  -H "Content-Type: application/json" \  -d '{}'
{
  "status": "string",
  "message": "string",
  "data": {
    "job_id": 0,
    "client_name": "string",
    "status": "string"
  }
}
Empty
Empty
Empty