Property hostnames

Number of APIs: 3

1. List hostnames for an account

GET https://{{host}}/papi/v1/hostnames

This operation lists active property hostnames for all properties available in an account. Use the optional query parameters to paginate, sort, and filter the results. You can nest and combine filters to obtain desired results. To view paginated results, use the response's nextLink and previousLink.

---

2. 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.

---

3. Get audit history

GET https://{{host}}/papi/v1/hostnames/:hostname/audit-history

Gets a detailed record of all modifications made to a property hostname.

---