---
search:
  tags:
    - database-services
    - POST
seo:
  description: >-
    Runs the resolved selection of the last Check (ADR… Reference for the POST
    /api/v1/database-services/{id}/upgrade endpoint in the TimescaleDB
    Enterprise API.
  noindex: true
sidebar:
  label: Upgrade a database service
  badge: POST
title: Upgrade a database service
type: openapi-operation
---
Runs the resolved selection of the last Check (ADR 2026-10-21 decision items 3 to 7): the pgBackRest step of the backup group, the rolling package pass (HA: the replicas one at a time, one switchover, the catalog step on the new leader, then the old leader; Standard: one stop and start), then the catalog step, then the component steps with no PostgreSQL restart, then Tailscale one server at a time (decision 30). The workflow is upgrade_service. 409 when the last Check did not pass, has no item, is older than one hour, was used by an Upgrade that completed, or no longer matches the service or the loaded server packages, when an operation runs on another service of a shared item, and when the Check warns about the backups and accept_backup_risk is not true.

`POST /api/v1/database-services/{id}/upgrade`

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

- `accept_backup_risk` (boolean) — Upgrade although the last Check warns about the backups: no backups configured, no successful backup in 24 hours, or WAL archiving not healthy (decision 6). The audit log records it.

Request body example:

```json
{
  "accept_backup_risk": true
}
```

**Responses**

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

Response example, 202:

```json
{
  "workflow_id": "string"
}
```
