Update a Certificate

Updates the Certificate properties.

Note: if the Certificate object changes during the request, the response will be a “conflict” error.

put/certificates/{id}

Request

Base URL: https://api.hetzner.cloud/v1
URL: https://api.hetzner.cloud/v1/certificates/{id}
Auth: HTTP bearer

Path parameters

idinteger required

ID of the Certificate.

Example:42

ID of the Certificate.

Request body

namestring

New Certificate name.

labelsobject

User-defined labels (key/value pairs) for the Resource.

Note that the set of Labels provided in the request will overwrite the existing one.

For more information, see "Labels".

Example request

{
  "name": "my website cert",
  "labels": {
    "environment": "prod",
    "example.com/my": "label",
    "just-a-key": ""
  }
}

Response

Request succeeded.

Example response

{
  "certificate": {
    "id": 42,
    "name": "my-resource",
    "labels": {
      "environment": "prod",
      "example.com/my": "label",
      "just-a-key": ""
    },
    "type": "uploaded",
    "certificate": "-----BEGIN CERTIFICATE-----\n...",
    "created": "2016-01-30T23:55:00Z",
    "not_valid_before": "2019-01-08T10:00:00Z",
    "not_valid_after": "2019-07-08T09:59:59Z",
    "domain_names": [
      "example.com",
      "webmail.example.com",
      "www.example.com"
    ],
    "fingerprint": "03:c7:55:9b:2a:d1:04:17:09:f6:d0:7f:18:34:63:d4:3e:5f",
    "status": {
      "issuance": "completed",
      "renewal": "scheduled"
    },
    "used_by": [
      {
        "id": 4711,
        "type": "load_balancer"
      }
    ]
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.