Sign in

v1

latestOpenAPI 3.0.02026-07-14198572488.4 KB
Custom SSL

Upload a custom SSL certificate for domains of this site

Your site SSL is initially managed by Cloudflare. This endpoint allows you to instead manage your SSL by uploading your own certificate.

post/v1/sites/{id}/ssl/certificates

Path parameters

idinteger required

ID of the Site you are interacting with

Example:8880000888

Request body

domainsstring[] required

a list of domains belonging to this site that this certificate will support

certificatestring required

the ssl certificate to use for each domain

keystring required

the certificate private key

Example request

{
  "domains": [
    "custom-ssl.com",
    "www.custom-ssl.com",
    "subdomain.custom-ssl.com"
  ],
  "certificate": "-----BEGIN CERTIFICATE-----\nMAoGCCqGSM49BAMD...\n-----END CERTIFICATE-----",
  "key": "-----BEGIN PRIVATE KEY-----\nMIGHAgEAMBMGByqG...\n-----END PRIVATE KEY-----"
}

Response

OK

idstring uuid

custom ssl record identifier

site_idinteger

id of the site associated with custom ssl record

serial_numberstring

the serial number of this custom ssl certificate

fingerprintstring

the SHA256 fingerprint of this custom ssl certificate

issuerstring

the issuer of this custom ssl certificate

uploaded_onstring date-time

the date this custom ssl certificate was uploaded

issued_onstring date-time

the date this custom ssl certificate was issued

expires_onstring date-time

the date this custom ssl certificate will expire

domainsstring[]

the Rocket.net domains that are associated with this custom ssl certificate

Example response

{
  "id": "1634ccc1-14a2-46b6-b886-95bdcc2efdab",
  "site_id": 12345,
  "serial_number": "398afaa14450d29e7a0905519a3e94cd0",
  "fingerprint": "1661186b8e38e79f434e4549a2d53f84716cfff7c45d334bbc67c9d41d1e3be6",
  "issuer": "LetsEncrypt",
  "uploaded_on": "2026-01-07 18:31:22",
  "issued_on": "2026-01-05 20:49:35",
  "expires_on": "2026-03-06 20:49:35",
  "domains": [
    "custom-ssl.com",
    "www.custom-ssl.com",
    "subdomain.custom-ssl.com"
  ]
}