Upload server packages
Loads the server packages of the request body, as ./timescale-enterprise.sh –pack does: a server package file, or a .tar file with server package files (the file of –make-bundle –packs-only). The console streams the body to the data volume, checks the name and the release of each file, checks the sha256 of each file against the SHA256SUMS of a .tar file, and verifies the signature. It refuses a bad name or a newer release (422) before it stores the body; it reads and discards the body of such a refusal, up to 2.5 GB, so that the client gets the refusal. The limit is 8.0 GB for each file (413). The data volume must have the size of the file (two times for a .tar file) and 1 GB more free (507). A pack with the same name is replaced. The response lists the loaded packs, and the pack list after the upload as GET /packs gives it.
/api/v1/packs/uploadtse_sessionAPI key · cookierequiredfile_namestringrequiredThe name of the file: timescale-enterprise-<release>-server-packages-<os>-<version>-<arch>.tar.zst, or a .tar file with such files (timescale-enterprise-<release>-server-packages.tar of --make-bundle --packs-only)
application/octet-streamstring<binary>OK
importedPackUploaded[]requiredThe packs of the file that the console loaded
Show propertiesHide properties
PackUploadednamestringrequiredPack name, without .tar.zst
textstringrequiredThe result line, as the pack-import command writes it
outdatedPackOutdated[]requiredThe outdated servers after the upload, as GET /packs gives them
Show propertiesHide properties
PackOutdatedarchstringrequiredamd64arm64commandstringrequiredThe installer command that loads the file
filestringrequiredThe file of the console release with the pack. For RHEL-compatible (el), * is the minor
labelstringrequiredThe OS version and the architecture, for example Debian 13 arm64 or RHEL-compatible 9 amd64 (RHEL, AlmaLinux, Rocky Linux, Oracle Linux, CentOS Stream)
osstringrequireddebianubuntuelos_versionstringrequiredThe OS version of the pack. For Debian and RHEL-compatible (el), the major only
releasestringrequiredThe release of the newest server packages that these servers get
serversstring[]requiredThe servers that get only server packages of older releases
packsPackResponse[]requiredThe packs after the upload
Show propertiesHide properties
PackResponsearchstringrequiredamd64arm64componentsPackComponentResponse[]requiredThe server components of a components pack, with their versions. Empty for an OS pack
Show propertiesHide properties
PackComponentResponsenamestringrequiredpostgresql_majorstringThe PostgreSQL major of tsdbe
versionstringrequiredinstalled_onPackInstalledOnResponserequiredThe 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 propertiesHide properties
serversstring[]requiredThe 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[]requiredThe deployed services of these servers
kindstringrequiredbaseextensionscomponentsnamestringrequiredPack name, without .tar.zst
older_releasebooleanrequiredThe pack is of a release older than the console (TSE-953). Always false on a dev console
osstringrequireddebian, ubuntu or el. Empty for a components pack
os_versionstringrequiredEmpty for a components pack
pinned_bystring[]requiredThe services that pin this pack: their PostgreSQL servers install from it. Empty for a components pack
postgresqlPackPGResponse[]requiredShow propertiesHide properties
PackPGResponsemajorstringrequiredminorstringrequiredtimescaledbstring[]requiredreasonstringWhy the console rejected the pack
releasestringrequiredremove_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_refusalstringWhy the console refuses to remove the pack now; empty when an admin can remove it
size_bytesinteger<int64>requiredverifiedbooleanrequiredreleasestringrequiredThe release of this console
release_missingPackReleaseMissing[]requiredThe missing server packages of the console release after the upload, as GET /packs gives them
Show propertiesHide properties
PackReleaseMissingarchstringrequiredamd64arm64commandstringrequiredThe installer command that loads the file
filestringrequiredThe file of the console release with the pack. For RHEL-compatible (el), * is the minor
kindstringrequiredbasecomponentslabelstringrequiredThe OS version and the architecture, for example Ubuntu 26.04 amd64, or Server components and the architecture
osstringrequireddebian, ubuntu or el. Empty for a components pack
os_versionstringrequiredThe OS version of the pack. For Debian and RHEL-compatible (el), the major only. Empty for a components pack
serversstring[]requiredThe enrolled servers that need the pack
Error
codestringStable code of the refusal, when the route has codes
detailsstring[]Additional detail, e.g. per-field validation failures
errorstringrequiredHuman-readable error message