---
title: "lego httpreq provider: withdraw a challenge"
method: POST
path: "/httpreq/cleanup"
---

# lego httpreq provider: withdraw a challenge

`POST /httpreq/cleanup`

## Request

- Base URL: `https://dnsmint.com/api`
- URL: `https://dnsmint.com/api/httpreq/cleanup`
- Auth: one of:
  - HTTP basic
  - HTTP bearer

The cleanup half of lego's httpreq provider. Same body and authentication as /httpreq/present. Withdrawing a value that is already gone is not an error, and a hostname in any status is accepted.

## Request body

- object
  - `fqdn` string, required: One of "_acme-challenge.<hostname>.", "_<account-label>._acme-challenge.<hostname>." for dns-account-01, or "_validation-persist.<hostname>.".
  - `value` string, required: For a challenge name, the 43-character DNS-01 key authorization. For _validation-persist, the grant: "<issuer>; accounturi=<uri>".

## Response `200`

Challenge withdrawn, or was not present

- object
  - `fqdn` string
  - `value` string

## Other responses

- `400`: Invalid JSON, fqdn is not a challenge name, value is not 43 characters, or RAW mode
- `401`: Missing or invalid API key
- `403`: Key lacks dns01:write, or is narrowed to another hostname
- `404`: No hostname by that name on this account
- `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)