Skip to content
You're viewing documentation for v2026.11.5-beta. It may be out of date.Go to latest
TimescaleDB Enterprise
Esc
↑↓navigate↵open⌘Jpreview

Upgrade the backup stanza

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/{id}/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
Authorization
tse_sessionAPI key · cookierequired
Path parameters
idstringrequired
Responses
202

Accepted

workflow_idstringrequired
default

Error

codestring

Stable code of the refusal, when the route has codes

detailsstring[]

Additional detail, e.g. per-field validation failures

errorstringrequired

Human-readable error message

Request
curl -X POST 'https://console.example.com/api/v1/database-services/string/major-upgrade/stanza' \
  -H 'Cookie: tse_session=YOUR_API_KEY' \
  -H 'Accept: application/json'
Response
{
  "workflow_id": "string"
}