Update a custom SSL certificate

PUT/v1/ssl_certificates/custom/{id}

A PUT request to /v1/ssl_certificates/custom/{id} updates a custom SSL certificate from the path parameter. To add a label, fill it in the request body.

Authorization

bearerAuth
AuthorizationBearer <token>

In: header

Path Parameters

FieldDetails
id
string

A unique identifier of a custom SSL certificate.

Request Body

FieldDetails
name?
string

Update a name of the certificate if necessary.

public_key?
string

Open a file containing a public key in the PEM format using a text editor. Usually, it has .pem, .crt, or .cer extensions. Copy and paste the file's content into this parameter with strings indicating a key's beginning and end.

The key has to be in accordance with the X.509 standard and be no longer than 32766 characters.

private_key?
string

By analogy to a public key, open a file and paste its content in this parameter. The private key file typically has the .key extension.

This key must also follow the X.509 standard and have no more than 32766 characters.

chain_key?
string

The chain key is an optional part of some certificates, also known as a chain of trust.

You can add intermediate and root certificates in this order. They are similar to the public key but belong to Certificate Authority.

labels?
object

Specify labels you want to attach to the resource. Refer to the Labels section for more details.

Response Body

application/json

application/json

curl -X PUT "https://example.com/v1/ssl_certificates/custom/MYerkEaO" \  -H "Content-Type: application/json" \  -d '{    "name": "name465",    "public_key": "-----BEGIN CERTIFICATE-----\\nMIICuDCCAiGgAwIBAgIBADANBgkqhkiG9w0BAQUFADBEMQswCQYDVQQGEwJCRTEO\\nMAwGA1UECgwFVGVzdE8xDzANBgNVBAsMBlRlc3RPVTEUMBIGA1UEAwwLc2VydmVy\\ncy5jb20wHhcNMjYwNTI4MDY1ODE1WhcNMzYwNTI4MDY1ODE1WjBEMQswCQYDVQQG\\nEwJCRTEOMAwGA1UECgwFVGVzdE8xDzANBgNVBAsMBlRlc3RPVTEUMBIGA1UEAwwL\\nc2VydmVycy5jb20wgZ8wDQYJKoZIhvcNAQEBBQADgY0AMIGJAoGBAMZv5zlLcYqs\\nGdPdLYvEWMZLWGAdn/xtN65bvTQsvB/VY7yN77ktZlXhABYQSA+BLkuvyobznwjy\\nYtbwzsnzyKUMkOl0ohDBNfMlS4hEN1QnHd/JnQnlXUE+TPUX7ujBB0oPRNaRlRAR\\nTinzcGH4Uctxw4GnZls6K+rLSaLcZ9bbAgMBAAGjgbkwgbYwDwYDVR0TAQH/BAUw\\nAwEB/zAdBgNVHQ4EFgQUfj+Naa3/lMDHcQXhAIF0rQ2fU6swFgYDVR0RBA8wDYIL\\nc2VydmVycy5jb20wbAYDVR0jBGUwY4AUfj+Naa3/lMDHcQXhAIF0rQ2fU6uhSKRG\\nMEQxCzAJBgNVBAYTAkJFMQ4wDAYDVQQKDAVUZXN0TzEPMA0GA1UECwwGVGVzdE9V\\nMRQwEgYDVQQDDAtzZXJ2ZXJzLmNvbYIBADANBgkqhkiG9w0BAQUFAAOBgQBIJMwF\\n1Ez4HCCSbvqg8EmAH20usYbl/BUGfi65rMrEeliRhT3wmHsnoby0sdtrh1D+lBrr\\no/9HzmTYMe8JZx6B1ULYfpkVws5P9FVmLL7srszFLx+Vv3fGwvqQ4Y+LBtK+sB5f\\nuRQ6ZicfeLU/JF0UVPTj1qE5PLNmJTQKfQ8vGQ==\\n-----END CERTIFICATE-----\\n",    "private_key": "-----BEGIN RSA PRIVATE KEY-----\\nMIICXQIBAAKBgQDGb+c5S3GKrBnT3S2LxFjGS1hgHZ/8bTeuW700LLwf1WO8je+5\\nLWZV4QAWEEgPgS5Lr8qG858I8mLW8M7J88ilDJDpdKIQwTXzJUuIRDdUJx3fyZ0J\\n5V1BPkz1F+7owQdKD0TWkZUQEU4p83Bh+FHLccOBp2ZbOivqy0mi3GfW2wIDAQAB\\nAoGAIXhSedl9xzQMDy4pNn/hsWCYAW49w+fwElqq6Rf6iywE7JLMMmGz9xxCVXZd\\nkS/qzR1TfbutwWaQwUxQtMOHvfLZQ0vjOH5SLCFrjvl77NA43uThZEwj09rUwpzs\\n/wNd00/FgvvccpwTuM9xcLWzZIXWeOMpu2TYPp9u3jZgEVECQQDvuAJlvCHLWabA\\n6uUE2kD91FIHyiyjeOFeWm5KJ6AQrrBd6qw6Ndw91vSysdF57va4K5Zsq5QEWw60\\neXFlCeQvAkEA0+ohKSYHYXEnfGx8aKiRAQtSnV1f1sFnjGAU6joPwWsE7a+DGevE\\nU4cHO2l5flZdwGzrPORnvD1BoDRXU18RFQJBANa+W39xkkCNdmF5y2GWdwQsMLQD\\nvAtRXWrdzdEmQDDRnPL1KAYZe8v2BU0TGFmH5YLEoUOGTNm+DKVF6Xwe6UcCQHbf\\noGhvv7YmfmrqhENFQ8odKuPBjFBwv4BcKX9WwJ3URbh7OwSgX8onNaRbP17iXcbi\\nknbe/V330sdmdRH8gx0CQQCaVwdV+yyBDmYYrjbZHaaMAfRRuqxj61kM9N258hhq\\n/j6iGXf1OyXU9oMbY+7kRJ61ekBO5JTd3yTk89O+Qe2e\\n-----END RSA PRIVATE KEY-----\\n",    "labels": {      "environment": "production",      "service": "my-web-app",      "example.com/project": "my-project",      "example.com/owner": "my-team"    }  }'
{  "id": "MYerkEaO",  "name": "name465",  "type": "custom",  "issuer": "servers.com",  "subject": "servers.com",  "domain_names": [    "servers.com"  ],  "sha1_fingerprint": "2961368ffc6d53dc645418c28ed590b8f2b02dd8",  "labels": {    "environment": "production",    "service": "my-web-app",    "example.com/project": "my-project",    "example.com/owner": "my-team"  },  "expires_at": "2036-05-28T06:58:15Z",  "created_at": "2026-05-28T06:58:15Z",  "updated_at": "2026-05-28T06:58:15Z"}