---
search:
  tags:
    - database-services
    - POST
seo:
  description: >-
    A rollback of a major upgrade (tier 1,… Reference for the POST
    /api/v1/database-services/{id}/major-upgrade/stanza endpoint in the
    TimescaleDB Enterprise API.
sidebar:
  label: Upgrade the backup stanza
  badge: POST
title: Upgrade the backup stanza
type: openapi-operation
---
A rollback of a major upgrade (tier 1, or tier 2 after a Copy upgrade) starts the earlier major and its clients first, then puts back the stanza file of the backup server and runs pgbackrest stanza-upgrade with the paths of the earlier major (ADR 2026-10-22, amendment of 2026-10-23). When that step fails, WAL archiving and backups fail, and GET /database-services/&#123;id&#125;/major-upgrade gives stanza_pending. This call runs the step alone on the server that led the window, then a full backup. The workflow is upgrade_major_stanza. 409 when no stanza step is pending, when that server left the service, or when another action runs.

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

**Responses**

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

Response example, 202:

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