Method Path Description
PUT /v1/cluster/update_cert Update a cluster certificate

Update cluster certificate

PUT /v1/cluster/update_cert

Replaces an existing certificate on all nodes within the cluster with a new certificate. The new certificate must pass validation before it can replace the old certificate.


Example HTTP request

PUT /cluster/update_cert

Example JSON body

    "name": "certificate1",
    "key": "-----BEGIN RSA PRIVATE KEY-----\n[key_content]\n-----END RSA PRIVATE KEY-----",
    "certificate": "-----BEGIN CERTIFICATE-----\n[cert_content]\n-----END CERTIFICATE-----",

Replace [key_content] with the content of the private key and [cert_content] with the content of the certificate.


Responds with the 200 OK status code if the certificate replacement succeeds across the entire cluster.

Otherwise, retry the certificate update in case the failure was due to a temporary issue in the cluster.

Status codes

Code Description
200 OK No error
400 Bad Request Failed, invalid certificate.
403 Forbidden Failed, unknown certificate.
404 Not Found Failed, invalid certificate.
406 Not Acceptable Failed, expired certificate.
409 Conflict Failed, not all nodes have been updated.