ACME

Download schema

Endpoints for completing ACME DNS-01 challenges to issue certificates.

Publish ACME challenge

POST

https://domain.chief.app/api/v1

/acme/challenges

OpenID Connect

Bearer (ctp_*)

Bearer (ctt_*)

Publish an ACME DNS-01 challenge value as a TXT record on an _acme-challenge name.

The domain is resolved from the name, using the most specific matching domain in your team. The domain must use hosted DNS.

Publishing a value that is already published returns the existing challenge with a 200 status. Other values on the same name are kept, so multiple challenges for the same name can be validated at the same time.

Challenge values that are not deleted are removed automatically after 24 hours.

Publish ACME challenge › Request Body

name

string · required

The fully qualified challenge name.

Example: _acme-challenge.www.example.com

value

string · pattern: ^[A-Za-z0-9_-]{1,255… · required

The challenge value.

Example: gfj9Xq...Rg85nM

Publish ACME challenge › Responses

ACMEChallenge

ACMEChallenge · required

Delete ACME challenge

DELETE

https://domain.chief.app/api/v1

/acme/challenges

OpenID Connect

Bearer (ctp_*)

Bearer (ctt_*)

Delete a published ACME DNS-01 challenge value from an _acme-challenge name.

Only the given value is deleted, other values on the same name are kept. The request succeeds when the value is not published.

Delete ACME challenge › query Parameters

name

string · required

The fully qualified challenge name.

value

string · maxLength: 255 · required

The challenge value to delete.

Delete ACME challenge › Responses

No data returned

DNS History Web Redirects