---
search:
  tags:
    - database-services
    - POST
seo:
  description: >-
    Resolves the picked items, and checks the… Reference for the POST
    /api/v1/database-services/{id}/upgrade/check endpoint in the TimescaleDB
    Enterprise API.
  noindex: true
sidebar:
  label: Check a service upgrade
  badge: POST
title: Check a service upgrade
type: openapi-operation
---
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/&#123;id&#125;/upgrade gives its report. 409 when the service does not run or another action runs.

`POST /api/v1/database-services/{id}/upgrade/check`

**Request body** (`application/json`, required)

- `items` (UpgradeRequest[]) — 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.

Request body example:

```json
{
  "items": [
    {
      "name": "string",
      "target": "string"
    }
  ]
}
```

**Responses**

- `202` — Accepted
- `default` — Error

Response example, 202:

```json
{
  "workflow_id": "string"
}
```
