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

Clean up a major upgrade

Removes the files of the earlier major after a major upgrade (ADR 2026-10-22 P4): the old data directory (in Link mode the two directories share the data files, so this frees only the old catalog and WAL; in Copy mode the full data directory; in Swap mode the files that pg_upgrade left), the old configuration, the tsdbe files and the packages of the old major, and its entry in the Debian minor pin. The service keeps running. The workflow is upgrade_major_cleanup. 409 until a full backup of the new major succeeds, and when the servers have no files of an earlier major.

POST/api/v1/database-services/{id}/major-upgrade/cleanup
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/cleanup' \
  -H 'Cookie: tse_session=YOUR_API_KEY' \
  -H 'Accept: application/json'
Response
{
  "workflow_id": "string"
}