---
title: "Publish a DNS-01 challenge value with the API key"
method: POST
path: "/v1/hostnames/{id}/acme-challenge"
---

# Publish a DNS-01 challenge value with the API key

`POST /v1/hostnames/{id}/acme-challenge`

## Request

- Base URL: `https://dnsmint.com/api`
- URL: `https://dnsmint.com/api/v1/hostnames/{id}/acme-challenge`
- Auth: HTTP bearer

Publishes the TXT value at _acme-challenge.HOSTNAME directly, authenticated by the API key rather than by a minted acme-dns credential. Same authorization as minting a credential (dns01:write, narrowed to the hostname if the key is), same two-newest rule and TTL on the record, and the same per-hostname rate budget as /acme/update. This is the path for a client that keeps no state: a credential's password is shown once and capped at five per hostname, so minting one per run would exhaust it.

## Path parameters

- `id` string, required

## Request body

- object
  - `txt` string, required

## Response `200`

Challenge published

- object
  - `txt` string

## Other responses

- `400`: Invalid JSON, or txt is not a 43-character challenge value
- `401`: Missing or invalid API key
- `403`: Key lacks dns01:write, or is narrowed to another hostname
- `404`: Hostname not found
- `409`: Hostname is released, suspended or terminated
- `429`: More than 20 challenge updates in a minute on this hostname
- `500`: Unexpected server error.

---

[API](https://skmtc.dev/dnsmint/apis/dnsmint-api.md) · [All operations](https://skmtc.dev/dnsmint/apis/dnsmint-api/llms.txt) · [OpenAPI document](https://skmtc.dev/dnsmint/apis/dnsmint-api/revisions/98fb1f87725a?raw)