GoDaddy
Support
API ReferenceIntegrationANS APICertificate ManagementVerify ACME challenges for pending server cert renewal POST

Verify ACME challenges for pending server cert renewal

View as Markdown

Triggers ACME validation for a pending server certificate renewal.

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

Authorization

AuthorizationBearer <token>

GoDaddy OAuth 2.0 access token sent as Authorization: Bearer <token>. The scope(s) listed on each operation are enforced per-operation. A token requires at least one of the scopes listed for that operation; ans.agent-registration:write implies ans.agent-registration:read on every ANS operation. Scopes do not apply to API key authentication.

In: header

Scope: ans.agent-registration:write

Path Parameters

agentId*string

Unique identifier of the agent (UUID format)

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X POST "https://example.com/v1/agents/string/certificates/server/renewal/verify-acme"
{  "status": "VERIFIED",  "csrId": "3081018b-0577-442d-b092-6e1f08ef6e0d",  "tlsaDnsRecord": {    "name": "string",    "priority": 0,    "purpose": "DISCOVERY",    "required": true,    "ttl": 3600,    "type": "HTTPS",    "value": "string"  },  "nextStep": {    "action": "CONFIGURE_DNS",    "description": "string",    "endpoint": "http://example.com"  }}

Last updated on

How is this guide?