Athena
Backups

List or create database backups

Returns completed backup jobs from `public.backup_jobs`, newest first, with optional client filtering and keyset pagination.

GET
/admin/backups

Query Parameters

client_name?string

When set, only list backups for this client.

limit?integer

Number of backup rows to return. Values above 10 are clamped.

Default10
Range1 <= value <= 10
cursor?string

Keyset pagination cursor from the previous response next_cursor, encoded as <completed_at>|<job_id>.

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.

Response Body

application/json

curl -X GET "https://athena-cluster.com/admin/backups" \  -H "apikey: string"
{
  "status": "string",
  "message": "string",
  "data": {
    "backups": [
      {
        "job_id": 0,
        "client_name": "string",
        "label": "string",
        "size_bytes": 0,
        "s3_bucket": "string",
        "s3_key": "string",
        "execution_daemon_id": "string",
        "completed_at": "2019-08-24T14:15:22Z"
      }
    ],
    "next_cursor": "string"
  }
}
Empty
Empty
Empty

Reset virgin counters (optionally truncate seen IPs) POST

Previous Page

List or create database backups POST

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).