---
search:
  tags:
    - servers
    - POST
seo:
  description: >-
    Trigger a pgbackrest backup on a server. Reference for the POST
    /api/v1/servers/{id}/backup endpoint in the TimescaleDB Enterprise API.
  noindex: true
sidebar:
  label: Trigger a server backup
  badge: POST
title: Trigger a server backup
type: openapi-operation
---
Trigger a pgbackrest backup on a server.

`POST /api/v1/servers/{id}/backup`

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

- `repo` (integer<int64>)
- `stanza` (string)
- `type` (string)

Request body example:

```json
{
  "repo": 0,
  "stanza": "string",
  "type": "string"
}
```

**Responses**

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

Response example, 202:

```json
{
  "repo": 0,
  "stanza": "string",
  "status": "string",
  "type": "string",
  "workflow_id": "string"
}
```
