# Verify ACME challenges for pending server cert renewal (https://developer.godaddy.com/en/docs/references/rest/ans/verify-acme-challenges)

---
title: Verify ACME challenges for pending server cert renewal
description: Triggers ACME validation for a pending server certificate renewal.
full: true
---

Full description

Triggers ACME validation for a pending server certificate renewal. Verifies the DNS-01 (TXT record) and HTTP-01 (file at /.well-known/acme-challenge) challenges. Returns 202 for CSR renewals (async issuance) or 200 for BYOC renewals (certificate stored).

## POST /v1/agents/{agentId}/certificates/server/renewal/verify-acme

Verify ACME challenges for pending server cert renewal

Triggers ACME validation for a pending server certificate renewal. Verifies the DNS-01 (TXT record) and HTTP-01 (file at /.well-known/acme-challenge) challenges. Returns 202 for CSR renewals (async issuance) or 200 for BYOC renewals (certificate stored).

### Path parameters

| Name | Type | Required | Description |
|------|------|----------|-------------|
| `agentId` | string | yes | Unique identifier of the agent (UUID format) |

### Responses

**200** — BYOC renewal completed synchronously.
TLSA record returned for DNS update.

Content-Type: `application/json`

Schema:

- schema reference: `#/components/schemas/RenewalVerification`

**202** — CSR renewal validation succeeded.
Certificate issuance in progress (poll GET /certificates/server).

Content-Type: `application/json`

Schema:

- schema reference: `#/components/schemas/RenewalVerification`

**401** — Authentication failed

Content-Type: `application/json`

Schema:

- schema reference: `#/components/schemas/ErrorResponse`

**403** — Authorization failed

Content-Type: `application/json`

Schema:

- schema reference: `#/components/schemas/ErrorResponse`

**404** — No pending renewal found

Content-Type: `application/json`

Schema:

- schema reference: `#/components/schemas/ErrorResponse`

**422** — Validation failed:
- No pending renewal found
- Renewal expired (>7 days old)
- ACME challenges not found in DNS/HTTP
- Agent not ACTIVE

Content-Type: `application/json`

Schema:

- schema reference: `#/components/schemas/ErrorResponse`

**500** — Internal server error

Content-Type: `application/json`

Schema:

- schema reference: `#/components/schemas/ErrorResponse`