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 DCS member slot

The server leaves the etcd member slot of a standalone DCS cluster and stays in Servers with its name and its mesh identity. If the server is online, the console stops and disables etcd on it and deletes 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. The other members must be healthy and keep a majority, no other slot can be empty or wait for a rebuild, and every service on the cluster must be healthy. Then fill the slot with a server.

POST/api/v1/dcs-clusters/{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/dcs-clusters/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"
}