open-vault/website/source/api/system/seal-status.html.md

1.1 KiB

layout page_title sidebar_current description
api /sys/seal-status - HTTP API docs-http-system-seal-status The `/sys/seal-status` endpoint is used to check the seal status of a Vault.

/sys/seal-status

The /sys/seal-status endpoint is used to check the seal status of a Vault.

Seal Status

This endpoint returns the seal status of the Vault. This is an unauthenticated endpoint.

Method Path Produces
GET /sys/seal-status 200 application/json

Sample Request

$ curl \
    https://vault.rocks/v1/sys/seal-status

Sample Response

The "t" parameter is the threshold, and "n" is the number of shares.

{
  "sealed": true,
  "t": 3,
  "n": 5,
  "progress": 2,
  "version": "0.6.2"
}

Sample response when Vault is unsealed.

{
  "sealed": false,
  "t": 3,
  "n": 5,
  "progress": 0,
  "version": "0.6.2",
  "cluster_name": "vault-cluster-d6ec3c7f",
  "cluster_id": "3e8b3fec-3749-e056-ba41-b62a63b997e8"
}