Certificates

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

post/operator/certificates/platform/acme

Request

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

Request body

organizationIdstring uuid required

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

namesstring[] required

the platform's own hostnames only: brand hosts, the app domain, CERTIFICATES_PLATFORM_HOSTS, and wildcards of them

reasonstring required

why (logged with the operator certificate decisions)

Response

Requested

idstring uuid required
organizationIdstring uuid required
namesstring[] required
state'awaiting_dns' | 'ready' | 'issuing' | 'issued' | 'failed' | 'canceled' required
certificateIdstring uuid nullable required
renewalOfstring uuid nullable required
attemptsinteger required
nextAttemptAtstring nullable required

ISO-8601 timestamp

lastErrorstring nullable required
createdAtstring required

ISO-8601 timestamp

updatedAtstring required

ISO-8601 timestamp

finishedAtstring nullable required

ISO-8601 timestamp

Changes

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