Custom Domain docs
API referenceSecure

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

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.

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: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"}