Status Page

Renew the certificate of a status page's custom domain

Changed on

Starts a new ACME order while the current certificate keeps being served. HTTP-01 completes immediately. DNS-01 returns renewal_pending with the new _acme-challenge TXT record: publish it, then call verify.

post/status-pages/{status_page_id}/domains/{domain_id}/renew

Request

  • Base URL: /api (relative, and the document was published on a file host, not at the API’s origin)
  • URL: /api/status-pages/{status_page_id}/domains/{domain_id}/renew
  • Auth: HTTP bearer

Path parameters

status_page_idinteger required

Status page ID

domain_idinteger required

Custom domain ID

Response

Renewal started (DNS-01) or completed (HTTP-01)

certificate_expires_atstring date-time nullable
created_atstring date-time required
hostnamestring required
idinteger required
last_errorstring nullable

Reason the last verification failed, if it did.

servingboolean required

True when visitors can open the page on this hostname right now: the hostname is verified and the page is published.

status'pending' | 'active' | 'failed' | 'unverified' | 'renewal_pending' | 'renewal_failed' required

Lifecycle of a custom hostname.

verification_method'http-01' | 'dns-01' required

How ownership of a hostname is proven.

Changes