Check a service upgrade
Resolves the picked items, and checks the service, its databases and its servers with no downtime (ADR 2026-10-21 decision items 3 and 6). The servers download the target packages to resolve them. The workflow is upgrade_service_check; GET /database-services/{id}/upgrade gives its report. 409 when the service does not run or another action runs.
/api/v1/database-services/{id}/upgrade/checktse_sessionAPI key · cookierequiredidstringrequiredapplication/jsonitemsUpgradeRequest[]The picked items. Empty: the default, every item at its newest version in the pinned release, and every console component at its newest version. A newer release is never a default.
Show propertiesHide properties
UpgradeRequestnamestringrequiredpostgresql, patroni, pgbouncer, haproxy, keepalived, the catalog name of an extension of the service (timescaledb, pgvector and so on), or a console component item: pgbackrest, tsdbe, etcd, confd, dcs_etcd, node_exporter, postgres_exporter, pgbouncer_exporter, sql_exporter, pg_auto_reindexer, tailscale, backup_server_tailscale, dcs_tailscale
targetstringThe version to move to. Empty: the newest version in the loaded server packages or server components. A component at the version that its servers have already is copied and restarted again.
Accepted
workflow_idstringrequiredError
codestringStable code of the refusal, when the route has codes
detailsstring[]Additional detail, e.g. per-field validation failures
errorstringrequiredHuman-readable error message