open-vault/website/source/docs/http/sys-replication.html.md

layout	page_title	sidebar_current	description
http	HTTP API: /sys/replication	docs-http-replication	The '/sys/replication' endpoint focuses on managing general operations in Vault Enterprise replication sets

/sys/replication/recover

POST

Description

Attempts recovery if replication is in an adverse state. For example: an error has caused replication to stop syncing.

Method

POST

URL

`/sys/replication/recover`

Parameters

None

Returns

A `200` response code and a warning.

/sys/replication/reindex

POST

Description

Requires ‘sudo’ capability. Reindex the local data storage. This can cause a very long delay depending on the number and size of objects in the data store.

Method

POST

URL

`/sys/replication/reindex`

Parameters

None

Returns

A `200` response code and a warning.

/sys/replication/status

GET

Description

Unauthenticated. Print information about the status of replication (mode, sync progress, etc).

Method

GET

URL

`/sys/replication/status`

Parameters

None

Returns

The printed status of the replication environment. As an example, for a primary, it will look something like:

```javascript
{
  "mode": "primary",
  "cluster_id": "d4095d41-3aee-8791-c421-9bc7f88f7c3e",
  "known_secondaries": [],
  "last_wal": 0,
  "merkle_root": "c3260c4c682ff2d6eb3c8bfd877134b3cec022d1",
  "request_id": "009ea98c-06cd-6dc3-74f2-c4904b22e535",
  "lease_id": "",
  "renewable": false,
  "lease_duration": 0,
  "data": {
    "cluster_id": "d4095d41-3aee-8791-c421-9bc7f88f7c3e",
    "known_secondaries": [],
    "last_wal": 0,
    "merkle_root": "c3260c4c682ff2d6eb3c8bfd877134b3cec022d1",
    "mode": "primary"
  },
  "wrap_info": null,
  "warnings": null,
  "auth": null
}
```