Certificates

Bring your own certificate for verified domains: certificate + chain + unencrypted private key (stored encrypted, never shown again)

post/certificates/managed

Request

  • Base URL: https://hostingsurge.com/api/v1
  • URL: https://hostingsurge.com/api/v1/certificates/managed
  • Auth: one of:
    • HTTP bearer
    • API key in cookie __Host-hs_session

Query parameters

orgIdstring

Organization id (required when you belong to several)

Request body

certificatePemstring required

PEM certificate; may also contain the chain after the leaf

chainPemstring

intermediate certificate(s), PEM

privateKeyPemstring required

unencrypted PEM private key (PKCS#8, PKCS#1 or SEC1); stored encrypted, never shown again

Response

Installed

idstring uuid required
organizationIdstring uuid required
source'upload' | 'acme' | 'reseller' required
namesstring[] required
commonNamestring nullable required
issuerstring required
serialstring required
fingerprintstring required
notBeforestring required

ISO-8601 timestamp

notAfterstring required

ISO-8601 timestamp

daysLeftinteger required
keyType'rsa' | 'ec' required
keyBitsinteger required
state'active' | 'replaced' | 'removed' | 'expired' | 'conflict' required
stateReasonstring nullable required
deliveryStatus'pending' | 'delivered' | 'error' | 'withdrawn' required
deliveryErrorstring nullable required
deliveredAtstring nullable required

ISO-8601 timestamp

serving'unknown' | 'serving' | 'shadowed' required

serving: the proxy presents this certificate; shadowed: it still presents another one (see docs)

servingCheckedAtstring nullable required

ISO-8601 timestamp

autoRenewboolean required
renewalOfstring uuid nullable required
replacedBystring uuid nullable required
orderIdstring uuid nullable required
acmeRequestIdstring uuid nullable required
certificatePemstring required

public certificate (leaf), PEM

chainPemstring required

intermediates, PEM

createdAtstring required

ISO-8601 timestamp

updatedAtstring required

ISO-8601 timestamp

Changes

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