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

Give a major upgrade grant

An air-gapped console cannot mint the licence grant of the new cluster. Upgrade then makes the new cluster and waits: GET /database-services/{id}/major-upgrade shows the fingerprint (last_upgrade.grant_wait). Check out a machine file for that fingerprint under the licence of the service, and send it here. The console verifies it, and the window starts. 409 when no Upgrade waits, or the grant is not for the new cluster and the licence of the service.

POST/api/v1/database-services/{id}/major-upgrade/grant
Authorization
tse_sessionAPI key · cookierequired
Path parameters
idstringrequired
Request body
requiredapplication/json
certificatestringrequired

Machine file contents (-----BEGIN MACHINE FILE----- ...)

Responses
204

No Content

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/grant' \
  -H 'Cookie: tse_session=YOUR_API_KEY' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
  "certificate": "string"
}'
Response
No Content