CustomDomain Docs
Secure

Record an operator-supplied (externally obtained) certificate's metadata

import connection certificate: CustomDomain™ API reference in the secure group. Covers request parameters, the request body, responses and error codes.

POST
/connections/{id}/ssl:import

Mirrors the status + validity window of an external certificate for display (managed=false, so the edge does not ACME-renew it). Private key material is an edge concern and is not handled here. Returns 409 when another application tracks the domain's certificate 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

application/json

curl -X POST "https://example.com/connections/string/ssl:import" \  -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"}
{  "code": "string",  "title": "string",  "details": "string"}