Upgrade a database service
Runs the resolved selection of the last Check (ADR 2026-10-21 decision items 3 to 7): the pgBackRest step of the backup group, the rolling package pass (HA: the replicas one at a time, one switchover, the catalog step on the new leader, then the old leader; single node: one stop and start), then the catalog step, then the component steps with no PostgreSQL restart, then Tailscale one server at a time (decision 30). The workflow is upgrade_service. 409 when the last Check did not pass, has no item, is older than one hour, was used by an Upgrade that completed, or no longer matches the service or the loaded server packages, when an operation runs on another service of a shared item, and when the Check warns about the backups and accept_backup_risk is not true.
/api/v1/database-services/{id}/upgradetse_sessionAPI key · cookierequiredidstringrequiredapplication/jsonaccept_backup_riskbooleanUpgrade although the last Check warns about the backups: no backups configured, no successful backup in 24 hours, or WAL archiving not healthy (decision 6). The audit log records it.
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