Certificates

Platform operators: upload a certificate for the platform's own hostnames, held by a team (fresh admin session and a reason; logged)

post/operator/certificates/platform/managed

Request

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

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

organizationIdstring uuid required

the team that will hold the certificate (usually the operators' own team)

reasonstring required

why (logged with the operator certificate decisions)

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.