---
search:
  tags:
    - console-backup
    - POST
seo:
  description: >-
    Starts one backup of the console to the target, with the… Reference for the
    POST /api/v1/console-backup/backups endpoint in the TimescaleDB Enterprise
    API.
sidebar:
  label: Back up the console now
  badge: POST
title: Back up the console now
type: openapi-operation
---
Starts one backup of the console to the target, with the tiers, and returns its run at once. Refused (409) until a recovery key is confirmed, and while another backup is running.

`POST /api/v1/console-backup/backups`

**Request body** (`application/json`, required)

- `target_id` (string, required)
- `tiers` (string[], required) — The tiers of the archive. core is always in. logs adds the logs of the finished workflows. packs adds the loaded server packs, not the packs of the image. metrics adds the Prometheus data. A tier that this release cannot back up gives 422 (size-estimate shows the available tiers)

Request body example:

```json
{
  "target_id": "string",
  "tiers": [
    "core"
  ]
}
```

**Responses**

- `202` — Accepted
- `default` — Error

Response example, 202:

```json
{
  "archive_name": "string",
  "error": "string",
  "finished_at": "2019-08-24T14:15:22Z",
  "id": "string",
  "schedule_id": "string",
  "size": 0,
  "started_at": "2019-08-24T14:15:22Z",
  "started_by": "string",
  "status": "running",
  "target_id": "string",
  "tiers": [
    "string"
  ],
  "trigger": "manual",
  "warning": "string"
}
```
