Check and perform a PostgreSQL minor upgrade

You can check whether a minor upgrade is available for your PostgreSQL cluster, then apply it if required.

info

A minor upgrade corresponds to a change within the same major version of PostgreSQL (for example, from 17.2 to 17.5). It includes bug fixes and stability improvements, without any change to the structure or compatibility of the data.

Permissions

info

This action requires the following IAM (Identity and Access Management) permissions:

postgresql.cluster.get (to check availability)
postgresql.cluster.update (to perform the upgrade)

Check the availability of a minor upgrade

The GET /postgresql/spaces/{spaceId}/clusters/{clusterId}/upgrade/minor request checks whether a minor upgrade is available for a PostgreSQL cluster.

Parameters

Parameter	Type	Required	Description
`spaceId`	UUID	Yes	Space identifier
`clusterId`	UUID	Yes	Unique cluster identifier

Example response

{
  "currentVersion": "17.2",
  "targetVersion": "17.5",
  "available": true
}

Field	Type	Description
`currentVersion`	string	Current minor version of the cluster
`targetVersion`	string	Available target minor version (`null` if no upgrade is available)
`available`	boolean	`true` if a minor upgrade is available, `false` otherwise

Perform a minor upgrade

The PUT /postgresql/spaces/{spaceId}/clusters/{clusterId}/upgrade/minor request upgrades the cluster to the latest minor version available for its current major version.

Parameters

Parameter	Type	Required	Description
`spaceId`	UUID	Yes	Space identifier
`clusterId`	UUID	Yes	Unique cluster identifier

Example response

{
  "id": "550e8400-e29b-41d4-a716-446655440001",
  "name": "my-cluster-postgresql",
  "databaseName": "appdb",
  "user": "admin",
  "majorVersion": "17",
  "fullVersion": "17.5",
  "status": {
    "state": "UPGRADING",
    "message": "Cluster is being upgraded"
  },
  "nodeConfiguration": {
    "vcpuCount": 2,
    "memorySizeGiB": 8
  },
  "volume": {
    "type": "GP2",
    "sizeGiB": 100
  },
  "visibility": "EXTERNAL",
  "replicaCount": 1,
  "host": "my-cluster-postgresql.postgres.eu-west-2.numspot.com",
  "port": 5432,
  "createdOn": "2026-04-05T10:30:00Z"
}

warning

The minor upgrade triggers a rolling restart of the cluster. If you have at least one replica, service availability is preserved.
Make sure that your applications handle temporary disconnections correctly during the upgrade.

See the full specification

Permissions​

Permissions