Skip to content
TimescaleDB Enterprise
Esc
↑↓navigate↵open⌘Jpreview

Rebuild a replica

Empties the data directory of a replica and clones the data again from the leader with Patroni. The server keeps its packages, its TLS files, its etcd member and its mesh address. The leader cannot be rebuilt: switch over first. Every other member must be healthy.

POST/api/v1/database-services/{id}/servers/{server_id}/rebuild-replica
Authorization
tse_sessionAPI key · cookierequired
Path parameters
idstringrequired
server_idstringrequired
Responses
202

Accepted

server_idstringrequired
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/servers/string/rebuild-replica' \
  -H 'Cookie: tse_session=YOUR_API_KEY' \
  -H 'Accept: application/json'
Response
{
  "server_id": "string",
  "workflow_id": "string"
}