SSL

Issue a certificate

Issue a managed Let's Encrypt certificate for domains you own. We auto-pick the validation method (see preflight). dry_run=true runs against Let's Encrypt staging — it exercises the whole flow (real DNS challenge) but issues an untrusted cert and consumes no production budget; always dry-run first. Issuance runs in the background: poll GET /v1/ssl/certificates/{id} for status.

post/v1/ssl/certificates

Request

  • Base URL: https://developers.servera.co.uk
  • URL: https://developers.servera.co.uk/v1/ssl/certificates
  • Auth: HTTP bearer

Request body

domainsstring[] required

Domain(s) for the certificate. First is the primary CN; use *.example.com for a wildcard.

dry_runboolean

Run against Let's Encrypt STAGING (validates everything, consumes NO production budget). Always dry-run first.

install_target'auto' | 'download' | 'edge' | 'cpanel' | 'deploy_agent'
csrstring nullable

Optional PEM CSR — keeps the private key on YOUR side (we never see it).

Example request

{
  "domains": [
    "example.lt",
    "www.example.lt"
  ],
  "dry_run": true,
  "install_target": "download"
}

Response

Successful Response

idinteger required
domainstring required
sansstring[]
methodstring required
install_targetstring required
statusstring required
environmentstring required
key_custodystring required
not_beforestring nullable
not_afterstring nullable
last_error_codestring nullable
created_atstring nullable
updated_atstring nullable

Changes

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