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

Fill a member slot

Puts a free server in the empty member slot and rebuilds the member on it: the server is cloned from the leader as a Patroni replica with the member name of the slot, and the peers drop the previous server. The server must be enrolled, online, answer over the mesh and be free (in no service, DCS cluster, backup role or LiveSync session, and not in need of a cleanup). Every other member must be healthy.

POST/api/v1/database-services/{id}/slots/{member_name}/fill
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
Request body
requiredapplication/json
server_idstringrequired

The free server that fills the slot. It must be enrolled, online and free.

min length 1
Responses
202

Accepted

member_namestringrequired
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/fill' \
  -H 'Cookie: tse_session=YOUR_API_KEY' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
  "server_id": "string"
}'
Response
{
  "member_name": "string",
  "server_id": "string",
  "server_name": "string",
  "workflow_id": "string"
}