Remove unused packages
Removes each pack that no server installed packages from (installed_on in GET /packs is empty), of each release, also the newest pack of a server, with the guard of DELETE /packs/{name}. Of two packs for the same used servers, it keeps the newer one. The response lists the removed packs, and the kept packs with the reason.
/api/v1/packs/remove-unusedtse_sessionAPI key · cookierequiredOK
keptPackKept[]requiredThe packs that the cleanup kept, with the reason: a server installed packages from the pack, or the removal guard refuses its removal
Show propertiesHide properties
PackKeptnamestringrequiredreasonstringrequiredloses_serversstring[]The enrolled servers with nothing deployed that had server packages before the cleanup and have none after it. The create wizard asks for their server packages again
packsPackResponse[]requiredThe packs after the cleanup
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>requiredverifiedbooleanrequiredremovedstring[]requiredThe packs that the cleanup removed
Error
codestringStable code of the refusal, when the route has codes
detailsstring[]Additional detail, e.g. per-field validation failures
errorstringrequiredHuman-readable error message