CustomDomain Docs
Secure

Record intent to issue an edge-managed certificate

Record intent to issue an edge-managed certificate: CustomDomain™ API reference in the secure group. Covers parameters, request body, responses and error codes.

POST
/connections/{id}/ssl:provision

Creates/updates the mirror row as pending + managed. The edge performs the actual ACME issuance on first handshake and reports back. Optionally sets secure_root_domain so the edge also secures the registrable apex. A domain has one certificate row. Returns 409 when another application tracks that row, unless this connection is the one the edge serves and the row's application serves nothing for the domain, in which case this connection takes the row over.

Authorization

AuthorizationBearer <token>

Short-lived widget JWT minted server-side via POST /v1/tokens. Scoped to one application (and optionally one domain).

In: header

Path Parameters

id*string

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

application/json

application/json

application/json

curl -X POST "https://example.com/connections/string/ssl:provision" \  -H "Content-Type: application/json" \  -d '{}'
{  "certificate": {    "id": "string",    "domain": "string",    "application_id": "string",    "status": "pending",    "issuer": "string",    "not_before": "2019-08-24T14:15:22Z",    "not_after": "2019-08-24T14:15:22Z",    "last_error": "string",    "managed": true,    "renew_after": "2019-08-24T14:15:22Z",    "updated_at": "2019-08-24T14:15:22Z"  }}
{  "code": "string",  "title": "string",  "details": "string"}
{  "code": "string",  "title": "string",  "details": "string"}
{  "code": "string",  "title": "string",  "details": "string"}
{  "code": "string",  "title": "string",  "details": "string"}