Logo
Akamai APIs API Documentation

Generate domain validation challenges

POST https://{{host}}/papi/v1/hostnames/certificate-challenges

If you're using Default Domain Validation (DV) certificates, you can generate the domain validation challenges ahead of setting hostnames for your property. Ordinarily, you get the challenges when you add hostnames to a property version or add hostnames to a property's hostname bucket. This operation returns the validationCname object that you use to validate the certificate's domain. For each requested property hostname, create a new CNAME record in the DNS configuration and map the object's hostname to the target.

Note: If you're using a new account, first register it on the Akamai network by activating any property version on either staging or production. Otherwise, your attempts to generate certificates will fail with a 403 error.

 

Body PARAM

Key Datatype Required Description 
accountSwitchKey
string (Optional) For customers who manage more than one account, this [runs the operation from another account](https://techdocs.akamai.com/developer/docs/manage-many-accounts-with-one-api-client). The Identity and Access Management API provides a [list of available account switch keys](https://techdocs.akamai.com/iam-api/reference/get-client-account-switch-keys).



HEADERS

Key Datatype Required Description 
Content-Type
string
Accept
string




RESPONSES

status OK

{ "accountId": "act_A-CCT9012", "hostnames": { "items": [ { "cnameFrom": "www.example1.com", "validationCname": { "hostname": "_acme-challenge.www.example1.com", "target": "ac.afae21b9a98d2d845d8032da0d689252.www.example1.com.validate-akdv.net" } }, { "cnameFrom": "www.example2.com", "validationCname": { "hostname": "_acme-challenge.www.example2.com.com", "target": "ac.afae21b9a98d2d845d8032da0d689252.www.example2.com.validate-akdv.net" } } ] } }

Curl
curl -X POST 'https://host/papi/v1/hostnames/certificate-challenges?accountSwitchKey=' -H 'Content-Type: application/json' -H 'Accept: application/json' -d '{"cnamesFrom":["www.example1.com","www.example2.com"]}'

ENDPOINTS