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

Remove server packages

Deletes the pack from the data volume. The console refuses (409) when a server of a deployed or pending service, of a DCS cluster, or a backup server then has no pack for its OS version and architecture, or when a deployed service then has no pack with its PostgreSQL, TimescaleDB and extension versions. It also refuses the pack whose release a deployed or pending service pins, for the OS version and architecture of its PostgreSQL servers, also when another pack has the same versions. The message names these servers and services. A server with nothing deployed does not keep a pack: see remove_loses_servers in GET /packs. The removal deletes the install records of the pack (installed_on in GET /packs). The installed packages stay on the servers.

DELETE/api/v1/packs/{name}
Authorization
tse_sessionAPI key · cookierequired
Path parameters
namestringrequired

Pack name, without .tar.zst

Responses
200

OK

outdatedPackOutdated[]required

The enrolled servers that get only server packages of releases older than the console, one item for each OS version, architecture and release (TSE-953). Load the server packages of the console release: new and replaced servers then get their fixes. A redeploy keeps the installed packages

Show properties
Array of PackOutdated
archstringrequired
Allowed:amd64arm64
commandstringrequired

The installer command that loads the file

filestringrequired

The file of the console release with the pack. For RHEL-compatible (el), * is the minor

labelstringrequired

The OS version and the architecture, for example Debian 13 arm64 or RHEL-compatible 9 amd64 (RHEL, AlmaLinux, Rocky Linux, Oracle Linux, CentOS Stream)

osstringrequired
Allowed:debianubuntuel
os_versionstringrequired

The OS version of the pack. For Debian and RHEL-compatible (el), the major only

releasestringrequired

The release of the newest server packages that these servers get

serversstring[]required

The servers that get only server packages of older releases

packsPackResponse[]required
Show properties
Array of PackResponse
archstringrequired
Allowed:amd64arm64
componentsPackComponentResponse[]required

The server components of a components pack, with their versions. Empty for an OS pack

Show properties
Array of PackComponentResponse
namestringrequired
postgresql_majorstring

The PostgreSQL major of tsdbe

versionstringrequired
installed_onPackInstalledOnResponserequired

The servers that installed packages from this pack, and their deployed services. For a components pack, the servers of its architecture that run a component version whose newest loaded source is this pack (TSE-1047, TSE-1094). POST /packs/remove-unused keeps the pack while this list has a server

Show properties
serversstring[]required

The servers that installed packages from the pack: a workflow started the package step on the server while the pack was the newest base pack of the server. The packages stay on the server after the removal of the pack

servicesstring[]required

The deployed services of these servers

kindstringrequired
Allowed:baseextensionscomponents
namestringrequired

Pack name, without .tar.zst

older_releasebooleanrequired

The pack is of a release older than the console (TSE-953). Always false on a dev console

osstringrequired

debian, ubuntu or el. Empty for a components pack

os_versionstringrequired

Empty for a components pack

pinned_bystring[]required

The services that pin this pack: their PostgreSQL servers install from it. Empty for a components pack

postgresqlPackPGResponse[]required
Show properties
Array of PackPGResponse
majorstringrequired
minorstringrequired
timescaledbstring[]required
reasonstring

Why the console rejected the pack

releasestringrequired
remove_loses_serversstring[]

The enrolled servers with nothing deployed that have no server packages after the removal of this pack. The create wizard asks for their server packages again

remove_refusalstring

Why the console refuses to remove the pack now; empty when an admin can remove it

size_bytesinteger<int64>required
verifiedbooleanrequired
releasestringrequired

The release of this console

release_missingPackReleaseMissing[]required

The server packages of the console release that the enrolled servers need and that the console does not have: one item for each OS version and architecture, and one for the server components of each architecture. The servers of pinned services count too. Empty on a dev console

Show properties
Array of PackReleaseMissing
archstringrequired
Allowed:amd64arm64
commandstringrequired

The installer command that loads the file

filestringrequired

The file of the console release with the pack. For RHEL-compatible (el), * is the minor

kindstringrequired
Allowed:basecomponents
labelstringrequired

The OS version and the architecture, for example Ubuntu 26.04 amd64, or Server components and the architecture

osstringrequired

debian, ubuntu or el. Empty for a components pack

os_versionstringrequired

The OS version of the pack. For Debian and RHEL-compatible (el), the major only. Empty for a components pack

serversstring[]required

The enrolled servers that need the pack

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 DELETE 'https://console.example.com/api/v1/packs/string' \
  -H 'Cookie: tse_session=YOUR_API_KEY' \
  -H 'Accept: application/json'
Response
{
  "outdated": [
    {
      "arch": "amd64",
      "command": "string",
      "file": "string",
      "label": "string",
      "os": "debian",
      "os_version": "string",
      "release": "string",
      "servers": [
        "string"
      ]
    }
  ],
  "packs": [
    {
      "arch": "amd64",
      "components": [
        {
          "name": "string",
          "postgresql_major": "string",
          "version": "string"
        }
      ],
      "installed_on": {
        "servers": [
          "string"
        ],
        "services": [
          "string"
        ]
      },
      "kind": "base",
      "name": "string",
      "older_release": true,
      "os": "string",
      "os_version": "string",
      "pinned_by": [
        "string"
      ],
      "postgresql": [
        {
          "major": "string",
          "minor": "string",
          "timescaledb": [
            "string"
          ]
        }
      ],
      "reason": "string",
      "release": "string",
      "remove_loses_servers": [
        "string"
      ],
      "remove_refusal": "string",
      "size_bytes": 0,
      "verified": true
    }
  ],
  "release": "string",
  "release_missing": [
    {
      "arch": "amd64",
      "command": "string",
      "file": "string",
      "kind": "base",
      "label": "string",
      "os": "string",
      "os_version": "string",
      "servers": [
        "string"
      ]
    }
  ]
}