Skip to content
You're viewing documentation for v2026.11.8-beta. It may be out of date.Go to latest
TimescaleDB Enterprise
Esc
↑↓navigate↵open⌘Jpreview

Release a member slot

The server leaves the member slot and stays in Servers with its name and its mesh identity. If the server is online: when the member leads, Patroni first switches over to a healthy replica; then the console stops and disables the services on the server and deletes its PostgreSQL data and its etcd data, and the server is free. If the server is unreachable: it leaves the slot at once, and the console deletes its data when it is online again; until then it needs cleanup and is not free. If the cleanup cannot remove a part, the server needs cleanup too. Every other member must be healthy, and no other slot can be empty or wait for a rebuild. Then fill the slot with a server.

POST/api/v1/database-services/{id}/slots/{member_name}/release
Authorization
tse_sessionAPI key · cookierequired
Path parameters
idstringrequired
member_namestringrequired

The member name of the slot: pgnodeNN for a database service, etcdNN for a DCS cluster.

max length 64
Responses
202

Accepted

member_namestringrequired
onlinebooleanrequired

true: the console stops, disables and wipes the server in the workflow. false: the server was unreachable; it leaves the slot without a wipe (at once, or on a service with a VIP when the workflow has raised the keepalived priority on the other members) and the console wipes it when it is online again.

server_idstringrequired
server_namestringrequired
workflow_idstringrequired
default

Error

codestring

Stable code of the refusal, when the route has codes

detailsstring[]

Additional detail, e.g. per-field validation failures

errorstringrequired

Human-readable error message

Request
curl -X POST 'https://console.example.com/api/v1/database-services/string/slots/string/release' \
  -H 'Cookie: tse_session=YOUR_API_KEY' \
  -H 'Accept: application/json'
Response
{
  "member_name": "string",
  "online": true,
  "server_id": "string",
  "server_name": "string",
  "workflow_id": "string"
}