--- updatedAt: 2026-03-01T18:48:58.000Z agentTools: siteIndex: https://techdocs.akamai.com/llms.txt projectIndex: https://techdocs.akamai.com/property-mgr/llms.txt --- # Generate certificate domain validation 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](ref:patch-property-version-hostnames) or [add hostnames to a property's hostname bucket](ref:patch-property-hostnames). 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](ref:403) error. # OpenAPI definition ```json { "externalDocs": { "description": "See documentation for Akamai's Property Manager API", "url": "https://techdocs.akamai.com/property-mgr/reference" }, "info": { "license": { "name": "Apache 2.0", "url": "https://www.apache.org/licenses/LICENSE-2.0.html" }, "title": "Property hostnames", "version": "v0" }, "openapi": "3.1.0", "paths": { "/hostnames/certificate-challenges": { "post": { "description": "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](https://techdocs.akamai.com/property-mgr/reference/patch-property-version-hostnames) or [add hostnames to a property's hostname bucket](https://techdocs.akamai.com/property-mgr/reference/patch-property-hostnames). 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`.\n\n**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](https://techdocs.akamai.com/property-mgr/reference/403) error.", "externalDocs": { "description": "See documentation for this operation in Akamai's Property Manager API", "url": "https://techdocs.akamai.com/property-mgr/reference/post-certificate-challenges" }, "operationId": "post-certificate-challenges", "parameters": [ { "description": "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).", "in": "query", "name": "accountSwitchKey", "required": false, "schema": { "example": "1-5C0YLB:1-8BYUX", "type": "string" } } ], "requestBody": { "content": { "application/json": { "example": { "cnamesFrom": [ "www.example1.com", "www.example2.com" ] }, "schema": { "$schema": "http://json-schema.org/draft-04/schema#", "description": "Creates domain validation challenges to validate the certificate's domain.", "existingJavaType": "com.akamai.luna.papi.model.PostCertificateChallengesRequest", "id": "resource:/descriptors/papi/v1/schemas/PostCertificateChallengesRequestV0.json#", "properties": { "cnamesFrom": { "description": "Lists the property hostnames to generate certificate domain validation challenges for. You can only specify property hostnames that you want to deploy using Default Domain Validation (DV) certificates.", "items": { "type": "string" }, "minItems": 1, "type": "array" } }, "required": [ "cnamesFrom" ], "type": "object", "x-akamai": { "file-path": "schemas/hostnames-certificate-challenges-request.yaml" } } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "example": { "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" } } ] } }, "schema": { "$schema": "http://json-schema.org/draft-04/schema#", "additionalProperties": false, "description": "A common outer wrapping object structure. It provides additional contextual details for a set of requested data. The data itself is available under various inner members' `items` array.", "existingJavaType": "com.akamai.luna.papi.model.PostCertificateChallengesResponse", "id": "resource:/descriptors/papi/v1/schemas/PostCertificateChallengesResponseV0.json#", "properties": { "accountId": { "description": "Identifies the prevailing account under which you requested the data. See [ID prefixes](https://techdocs.akamai.com/property-mgr/reference/id-prefixes) for details on how to omit the ID's `act_` prefix.", "type": "string" }, "hostnames": { "additionalProperties": false, "description": "The set of requested Default Domain Validation (DV) certificate challenges, available within an `items` array.", "properties": { "items": { "description": "Specifies the certificate domain validation challenges for your property hostnames. Relevant response objects appear within the outer [Envelope](#envelope) object's `hostnames.items` array.", "items": { "additionalProperties": false, "properties": { "cnameFrom": { "description": "The hostname that your end users see, indicated by the `Host` header in end user requests.", "type": "string" }, "validationCname": { "additionalProperties": false, "description": "The CNAME record used to validate the certificate's domain.", "properties": { "hostname": { "description": "The hostname part of the CNAME record used to validate the certificate's domain.", "type": "string" }, "target": { "description": "The destination part of the CNAME record used to validate the certificate's domain.", "type": "string" } }, "required": [ "hostname", "target" ], "type": "object" } }, "required": [ "cnameFrom", "validationCname" ], "type": "object" }, "type": "array" } }, "type": "object" } }, "type": "object", "x-akamai": { "file-path": "schemas/hostnames-certificate-challenges-post-response.yaml" } } } }, "description": "The response shows default certificate's domain validation challenges for the requested property hostnames.", "headers": { "X-RateLimit-Limit": { "description": "Maximum sustainable number of request allowed each minute per account. This rate limit protects PAPI resources from being exhausted by single users. Once you exceed the limit, you receive the [429](https://techdocs.akamai.com/property-mgr/reference/429) error. If you call PAPI using multiple API clients within the same account, the rate limit applies globally to all API clients.\n\nThis API also provides a burst limit that specifies how many requests you can make in excess of the imposed rate limit. The one-time burst limit is 1000 requests. Once you consume all available resources, the burst capacity increases steadily by 100 requests every minute, until it reaches its initial maximum limit of 1000.", "schema": { "type": "integer" }, "x-akamai": { "file-path": "headers/x-rate-limit-limit.yaml" } }, "X-RateLimit-Remaining": { "description": "Remaining number of requests allowed each minute per account. See [Rate and resource limiting](https://techdocs.akamai.com/property-mgr/reference/rate-and-resource-limiting) for details.", "schema": { "type": "integer" }, "x-akamai": { "file-path": "headers/x-rate-limit-remaining.yaml" } } } }, "400": { "content": { "application/problem+json": { "example": { "detail": "The system cannot understand your request. Please check the syntax and correct any problems.", "instance": "/papi/v1/properties?contractId=ctr_K-0N7RAK71&groupId=grp_12345#abc12345abcc02a7", "status": 400, "title": "Bad Request", "type": "https://problems.luna.akamaiapis.net/papi/v0/http/bad-request" }, "schema": { "additionalProperties": false, "description": "Represents error data in the [RFC 7807](https://www.rfc-editor.org/rfc/rfc7807) Problem Details format.", "properties": { "detail": { "description": "Diagnostic instructions to locate and fix the problem.", "minLength": 1, "type": "string" }, "errors": { "description": "For errors with more than one detected problem, this represents each as a nested Problem Details object.", "items": { "additionalProperties": false, "description": "Represents error data in the [RFC 7807](https://www.rfc-editor.org/rfc/rfc7807) Problem Details format.", "properties": { "detail": { "description": "Diagnostic instructions to locate and fix the problem.", "minLength": 1, "type": "string" }, "instance": { "description": "Unique value generated with each API call.", "minLength": 1, "type": "string" }, "status": { "description": "The HTTP status code that categorizes this error case.", "maximum": 600, "minimum": 100, "type": "integer" }, "title": { "description": "A summary of each error case.", "minLength": 1, "type": "string" }, "type": { "description": "Identifies each error case.", "format": "uri", "type": "string" } }, "required": [ "type", "title", "detail" ], "type": "object", "x-akamai": { "file-path": "schemas/problem-nested.yaml" } }, "minItems": 0, "type": "array", "uniqueItems": true }, "instance": { "description": "Unique value generated with each API call.", "minLength": 1, "type": "string" }, "status": { "description": "The HTTP status code that categorizes this error case.", "maximum": 600, "minimum": 100, "type": "integer" }, "title": { "description": "A summary of each error case.", "minLength": 1, "type": "string" }, "type": { "description": "Identifies each error case.", "format": "uri", "type": "string" } }, "required": [ "type", "title", "status", "detail", "instance" ], "type": "object", "x-akamai": { "file-path": "schemas/problem.yaml" } } } }, "description": "[Bad request](https://techdocs.akamai.com/property-mgr/reference/400).", "x-akamai": { "file-path": "errors/400.yaml" } }, "401": { "content": { "application/problem+json": { "example": { "detail": "The request requires authentication.", "instance": "/papi/v1/properties?contractId=ctr_C-0N7RAC71&groupId=grp_12345#abc12345abcc02a7", "status": 401, "title": "Unauthorized", "type": "https://problems.luna.akamaiapis.net/papi/v0/http/unauthorized" }, "schema": { "additionalProperties": false, "description": "Represents error data in the [RFC 7807](https://www.rfc-editor.org/rfc/rfc7807) Problem Details format.", "properties": { "detail": { "description": "Diagnostic instructions to locate and fix the problem.", "minLength": 1, "type": "string" }, "errors": { "description": "For errors with more than one detected problem, this represents each as a nested Problem Details object.", "items": { "additionalProperties": false, "description": "Represents error data in the [RFC 7807](https://www.rfc-editor.org/rfc/rfc7807) Problem Details format.", "properties": { "detail": { "description": "Diagnostic instructions to locate and fix the problem.", "minLength": 1, "type": "string" }, "instance": { "description": "Unique value generated with each API call.", "minLength": 1, "type": "string" }, "status": { "description": "The HTTP status code that categorizes this error case.", "maximum": 600, "minimum": 100, "type": "integer" }, "title": { "description": "A summary of each error case.", "minLength": 1, "type": "string" }, "type": { "description": "Identifies each error case.", "format": "uri", "type": "string" } }, "required": [ "type", "title", "detail" ], "type": "object", "x-akamai": { "file-path": "schemas/problem-nested.yaml" } }, "minItems": 0, "type": "array", "uniqueItems": true }, "instance": { "description": "Unique value generated with each API call.", "minLength": 1, "type": "string" }, "status": { "description": "The HTTP status code that categorizes this error case.", "maximum": 600, "minimum": 100, "type": "integer" }, "title": { "description": "A summary of each error case.", "minLength": 1, "type": "string" }, "type": { "description": "Identifies each error case.", "format": "uri", "type": "string" } }, "required": [ "type", "title", "status", "detail", "instance" ], "type": "object", "x-akamai": { "file-path": "schemas/problem.yaml" } } } }, "description": "[Unauthorized](https://techdocs.akamai.com/property-mgr/reference/401).", "x-akamai": { "file-path": "errors/401.yaml" } }, "403": { "content": { "application/problem+json": { "example": { "detail": "The authorization token you provided does not allow access to this resource.", "instance": "/papi/v1/properties?contractId=ctr_C-0N7RAC71&groupId=grp_12345#abc12345abcc02a7", "status": 403, "title": "Forbidden", "type": "https://problems.luna.akamaiapis.net/papi/v1/http/forbidden" }, "schema": { "additionalProperties": false, "description": "Represents error data in the [RFC 7807](https://www.rfc-editor.org/rfc/rfc7807) Problem Details format.", "properties": { "detail": { "description": "Diagnostic instructions to locate and fix the problem.", "minLength": 1, "type": "string" }, "errors": { "description": "For errors with more than one detected problem, this represents each as a nested Problem Details object.", "items": { "additionalProperties": false, "description": "Represents error data in the [RFC 7807](https://www.rfc-editor.org/rfc/rfc7807) Problem Details format.", "properties": { "detail": { "description": "Diagnostic instructions to locate and fix the problem.", "minLength": 1, "type": "string" }, "instance": { "description": "Unique value generated with each API call.", "minLength": 1, "type": "string" }, "status": { "description": "The HTTP status code that categorizes this error case.", "maximum": 600, "minimum": 100, "type": "integer" }, "title": { "description": "A summary of each error case.", "minLength": 1, "type": "string" }, "type": { "description": "Identifies each error case.", "format": "uri", "type": "string" } }, "required": [ "type", "title", "detail" ], "type": "object", "x-akamai": { "file-path": "schemas/problem-nested.yaml" } }, "minItems": 0, "type": "array", "uniqueItems": true }, "instance": { "description": "Unique value generated with each API call.", "minLength": 1, "type": "string" }, "status": { "description": "The HTTP status code that categorizes this error case.", "maximum": 600, "minimum": 100, "type": "integer" }, "title": { "description": "A summary of each error case.", "minLength": 1, "type": "string" }, "type": { "description": "Identifies each error case.", "format": "uri", "type": "string" } }, "required": [ "type", "title", "status", "detail", "instance" ], "type": "object", "x-akamai": { "file-path": "schemas/problem.yaml" } } } }, "description": "[Forbidden](https://techdocs.akamai.com/property-mgr/reference/403).", "x-akamai": { "file-path": "errors/403.yaml" } }, "404": { "content": { "application/problem+json": { "example": { "detail": "The system was unable to locate the requested resource.", "instance": "/papi/v1/properties?contractId=ctr_K-0N7RAK7&groupId=grp_12345#abc12345abcc02a7", "status": 404, "title": "Not Found", "type": "https://problems.luna.akamaiapis.net/papi/v1/http/not-found" }, "schema": { "additionalProperties": false, "description": "Represents error data in the [RFC 7807](https://www.rfc-editor.org/rfc/rfc7807) Problem Details format.", "properties": { "detail": { "description": "Diagnostic instructions to locate and fix the problem.", "minLength": 1, "type": "string" }, "errors": { "description": "For errors with more than one detected problem, this represents each as a nested Problem Details object.", "items": { "additionalProperties": false, "description": "Represents error data in the [RFC 7807](https://www.rfc-editor.org/rfc/rfc7807) Problem Details format.", "properties": { "detail": { "description": "Diagnostic instructions to locate and fix the problem.", "minLength": 1, "type": "string" }, "instance": { "description": "Unique value generated with each API call.", "minLength": 1, "type": "string" }, "status": { "description": "The HTTP status code that categorizes this error case.", "maximum": 600, "minimum": 100, "type": "integer" }, "title": { "description": "A summary of each error case.", "minLength": 1, "type": "string" }, "type": { "description": "Identifies each error case.", "format": "uri", "type": "string" } }, "required": [ "type", "title", "detail" ], "type": "object", "x-akamai": { "file-path": "schemas/problem-nested.yaml" } }, "minItems": 0, "type": "array", "uniqueItems": true }, "instance": { "description": "Unique value generated with each API call.", "minLength": 1, "type": "string" }, "status": { "description": "The HTTP status code that categorizes this error case.", "maximum": 600, "minimum": 100, "type": "integer" }, "title": { "description": "A summary of each error case.", "minLength": 1, "type": "string" }, "type": { "description": "Identifies each error case.", "format": "uri", "type": "string" } }, "required": [ "type", "title", "status", "detail", "instance" ], "type": "object", "x-akamai": { "file-path": "schemas/problem.yaml" } } } }, "description": "[Not found](https://techdocs.akamai.com/property-mgr/reference/404).", "x-akamai": { "file-path": "errors/404.yaml" } }, "405": { "content": { "application/problem+json": { "example": { "detail": "The system does not support the method you provided for this resource.", "instance": "/papi/v1/properties?contractId=ctr_C-0N7RAC71&groupId=grp_12345#abc12345abcc02a7", "status": 405, "title": "Method not allowed", "type": "https://problems.luna.akamaiapis.net/papi/v1/http/method-not-allowed" }, "schema": { "additionalProperties": false, "description": "Represents error data in the [RFC 7807](https://www.rfc-editor.org/rfc/rfc7807) Problem Details format.", "properties": { "detail": { "description": "Diagnostic instructions to locate and fix the problem.", "minLength": 1, "type": "string" }, "errors": { "description": "For errors with more than one detected problem, this represents each as a nested Problem Details object.", "items": { "additionalProperties": false, "description": "Represents error data in the [RFC 7807](https://www.rfc-editor.org/rfc/rfc7807) Problem Details format.", "properties": { "detail": { "description": "Diagnostic instructions to locate and fix the problem.", "minLength": 1, "type": "string" }, "instance": { "description": "Unique value generated with each API call.", "minLength": 1, "type": "string" }, "status": { "description": "The HTTP status code that categorizes this error case.", "maximum": 600, "minimum": 100, "type": "integer" }, "title": { "description": "A summary of each error case.", "minLength": 1, "type": "string" }, "type": { "description": "Identifies each error case.", "format": "uri", "type": "string" } }, "required": [ "type", "title", "detail" ], "type": "object", "x-akamai": { "file-path": "schemas/problem-nested.yaml" } }, "minItems": 0, "type": "array", "uniqueItems": true }, "instance": { "description": "Unique value generated with each API call.", "minLength": 1, "type": "string" }, "status": { "description": "The HTTP status code that categorizes this error case.", "maximum": 600, "minimum": 100, "type": "integer" }, "title": { "description": "A summary of each error case.", "minLength": 1, "type": "string" }, "type": { "description": "Identifies each error case.", "format": "uri", "type": "string" } }, "required": [ "type", "title", "status", "detail", "instance" ], "type": "object", "x-akamai": { "file-path": "schemas/problem.yaml" } } } }, "description": "[Method not allowed](https://techdocs.akamai.com/property-mgr/reference/405).", "x-akamai": { "file-path": "errors/405.yaml" } }, "406": { "content": { "application/problem+json": { "example": { "detail": "The system does not support the content-type restrictions provided by your 'Accept' header.", "instance": "papi/v1/build#abc12345abcc02a7", "status": 406, "title": "Not Acceptable", "type": "https://problems.luna.akamaiapis.net/papi/v1/http/not-acceptable" }, "schema": { "additionalProperties": false, "description": "Represents error data in the [RFC 7807](https://www.rfc-editor.org/rfc/rfc7807) Problem Details format.", "properties": { "detail": { "description": "Diagnostic instructions to locate and fix the problem.", "minLength": 1, "type": "string" }, "errors": { "description": "For errors with more than one detected problem, this represents each as a nested Problem Details object.", "items": { "additionalProperties": false, "description": "Represents error data in the [RFC 7807](https://www.rfc-editor.org/rfc/rfc7807) Problem Details format.", "properties": { "detail": { "description": "Diagnostic instructions to locate and fix the problem.", "minLength": 1, "type": "string" }, "instance": { "description": "Unique value generated with each API call.", "minLength": 1, "type": "string" }, "status": { "description": "The HTTP status code that categorizes this error case.", "maximum": 600, "minimum": 100, "type": "integer" }, "title": { "description": "A summary of each error case.", "minLength": 1, "type": "string" }, "type": { "description": "Identifies each error case.", "format": "uri", "type": "string" } }, "required": [ "type", "title", "detail" ], "type": "object", "x-akamai": { "file-path": "schemas/problem-nested.yaml" } }, "minItems": 0, "type": "array", "uniqueItems": true }, "instance": { "description": "Unique value generated with each API call.", "minLength": 1, "type": "string" }, "status": { "description": "The HTTP status code that categorizes this error case.", "maximum": 600, "minimum": 100, "type": "integer" }, "title": { "description": "A summary of each error case.", "minLength": 1, "type": "string" }, "type": { "description": "Identifies each error case.", "format": "uri", "type": "string" } }, "required": [ "type", "title", "status", "detail", "instance" ], "type": "object", "x-akamai": { "file-path": "schemas/problem.yaml" } } } }, "description": "[Not acceptable](https://techdocs.akamai.com/property-mgr/reference/406).", "x-akamai": { "file-path": "errors/406.yaml" } }, "415": { "content": { "application/problem+json": { "example": { "detail": "Our system does not support requests in the format you're sending.", "instance": "/papi/v1/properties?contractId=ctr_K-0N7RAK71&groupId=grp_12345#abc12345abcc02a7", "status": 415, "title": "Unsupported Media Type", "type": "https://problems.luna.akamaiapis.net/papi/v1/http/unsupported-media-type" }, "schema": { "additionalProperties": false, "description": "Represents error data in the [RFC 7807](https://www.rfc-editor.org/rfc/rfc7807) Problem Details format.", "properties": { "detail": { "description": "Diagnostic instructions to locate and fix the problem.", "minLength": 1, "type": "string" }, "errors": { "description": "For errors with more than one detected problem, this represents each as a nested Problem Details object.", "items": { "additionalProperties": false, "description": "Represents error data in the [RFC 7807](https://www.rfc-editor.org/rfc/rfc7807) Problem Details format.", "properties": { "detail": { "description": "Diagnostic instructions to locate and fix the problem.", "minLength": 1, "type": "string" }, "instance": { "description": "Unique value generated with each API call.", "minLength": 1, "type": "string" }, "status": { "description": "The HTTP status code that categorizes this error case.", "maximum": 600, "minimum": 100, "type": "integer" }, "title": { "description": "A summary of each error case.", "minLength": 1, "type": "string" }, "type": { "description": "Identifies each error case.", "format": "uri", "type": "string" } }, "required": [ "type", "title", "detail" ], "type": "object", "x-akamai": { "file-path": "schemas/problem-nested.yaml" } }, "minItems": 0, "type": "array", "uniqueItems": true }, "instance": { "description": "Unique value generated with each API call.", "minLength": 1, "type": "string" }, "status": { "description": "The HTTP status code that categorizes this error case.", "maximum": 600, "minimum": 100, "type": "integer" }, "title": { "description": "A summary of each error case.", "minLength": 1, "type": "string" }, "type": { "description": "Identifies each error case.", "format": "uri", "type": "string" } }, "required": [ "type", "title", "status", "detail", "instance" ], "type": "object", "x-akamai": { "file-path": "schemas/problem.yaml" } } } }, "description": "[Unsupported media type](https://techdocs.akamai.com/property-mgr/reference/415).", "x-akamai": { "file-path": "errors/415.yaml" } }, "429": { "content": { "application/problem+json": { "example": { "detail": "Too many includes exist on contract ctr_1-12345. You must delete an include before continuing.", "instance": "/papi/v1/includes?contractId=ctr_K-0N7RAK7&groupId=grp_12345#abc12345abcc02a7", "instanceKey": "1-12345", "limit": 500, "limitKey": "INCLUDES_PER_CONTRACT", "remaining": 0, "status": 429, "title": "Too many includes", "type": "https://problems.luna.akamaiapis.net/papi/v1/limit-exceeded" }, "schema": { "additionalProperties": false, "description": "Represents error data in the [RFC 7807](https://www.rfc-editor.org/rfc/rfc7807) Problem Details format.", "properties": { "detail": { "description": "Diagnostic instructions to locate and fix the problem.", "minLength": 1, "type": "string" }, "errors": { "description": "For errors with more than one detected problem, this represents each as a nested Problem Details object.", "items": { "additionalProperties": false, "description": "Represents error data in the [RFC 7807](https://www.rfc-editor.org/rfc/rfc7807) Problem Details format.", "properties": { "detail": { "description": "Diagnostic instructions to locate and fix the problem.", "minLength": 1, "type": "string" }, "instance": { "description": "Unique value generated with each API call.", "minLength": 1, "type": "string" }, "status": { "description": "The HTTP status code that categorizes this error case.", "maximum": 600, "minimum": 100, "type": "integer" }, "title": { "description": "A summary of each error case.", "minLength": 1, "type": "string" }, "type": { "description": "Identifies each error case.", "format": "uri", "type": "string" } }, "required": [ "type", "title", "detail" ], "type": "object", "x-akamai": { "file-path": "schemas/problem-nested.yaml" } }, "minItems": 0, "type": "array", "uniqueItems": true }, "instance": { "description": "Unique value generated with each API call.", "minLength": 1, "type": "string" }, "instanceKey": { "description": "Identifies the resource the limit is imposed on.", "minLength": 1, "type": "string" }, "limit": { "description": "The overall limit.", "type": "integer" }, "limitKey": { "description": "The limit that got exceeded with the operation.", "minLength": 1, "type": "string" }, "remaining": { "description": "Number of items left to deploy.", "type": "integer" }, "status": { "description": "The HTTP status code that categorizes this error case.", "maximum": 600, "minimum": 100, "type": "integer" }, "title": { "description": "A summary of each error case.", "minLength": 1, "type": "string" }, "type": { "description": "Identifies each error case.", "format": "uri", "type": "string" } }, "required": [ "type", "title", "status", "detail", "instance", "limitKey", "instanceKey", "limit", "remaining" ], "type": "object", "x-akamai": { "file-path": "schemas/problem-429.yaml" } } } }, "description": "[Too many requests](https://techdocs.akamai.com/property-mgr/reference/429).", "x-akamai": { "file-path": "errors/429.yaml" } }, "500": { "content": { "application/problem+json": { "example": { "detail": "Our system is experiencing errors. We''ll get this fixed as soon as possible.", "instance": "/papi/v1/properties/12345/activations#abc12345abcc02a7", "status": 500, "title": "Internal Server Error", "type": "https://problems.luna.akamaiapis.net/papi/proxy/internal-server-error" }, "schema": { "additionalProperties": false, "description": "Represents error data in the [RFC 7807](https://www.rfc-editor.org/rfc/rfc7807) Problem Details format.", "properties": { "detail": { "description": "Diagnostic instructions to locate and fix the problem.", "minLength": 1, "type": "string" }, "errors": { "description": "For errors with more than one detected problem, this represents each as a nested Problem Details object.", "items": { "additionalProperties": false, "description": "Represents error data in the [RFC 7807](https://www.rfc-editor.org/rfc/rfc7807) Problem Details format.", "properties": { "detail": { "description": "Diagnostic instructions to locate and fix the problem.", "minLength": 1, "type": "string" }, "instance": { "description": "Unique value generated with each API call.", "minLength": 1, "type": "string" }, "status": { "description": "The HTTP status code that categorizes this error case.", "maximum": 600, "minimum": 100, "type": "integer" }, "title": { "description": "A summary of each error case.", "minLength": 1, "type": "string" }, "type": { "description": "Identifies each error case.", "format": "uri", "type": "string" } }, "required": [ "type", "title", "detail" ], "type": "object", "x-akamai": { "file-path": "schemas/problem-nested.yaml" } }, "minItems": 0, "type": "array", "uniqueItems": true }, "instance": { "description": "Unique value generated with each API call.", "minLength": 1, "type": "string" }, "status": { "description": "The HTTP status code that categorizes this error case.", "maximum": 600, "minimum": 100, "type": "integer" }, "title": { "description": "A summary of each error case.", "minLength": 1, "type": "string" }, "type": { "description": "Identifies each error case.", "format": "uri", "type": "string" } }, "required": [ "type", "title", "status", "detail", "instance" ], "type": "object", "x-akamai": { "file-path": "schemas/problem.yaml" } } } }, "description": "[Internal server error](https://techdocs.akamai.com/property-mgr/reference/500).", "x-akamai": { "file-path": "errors/500.yaml" } } }, "summary": "Generate certificate domain validation challenges", "tags": [ "Property hostnames" ] }, "x-akamai": { "file-path": "paths/hostname-certificate-challenges.yaml", "path-for-file": "/hostnames/certificate-challenges" }, "x-akamai-descriptor-tools": { "displayName": "certificateChallenges", "group": "Hostnames" } } }, "servers": [ { "url": "https://{hostname}/papi/v1" } ], "x-akamai": { "auth-type": "EDGE_GRID", "file-path": "03-property-hostnames.yaml" }, "x-readme": { "samples-languages": [ "curl", "python", "node" ], "explorer-enabled": true, "proxy-enabled": true } } ``` # Sibling pages * [List hostnames for an account](https://techdocs.akamai.com/property-mgr/reference/get-hostnames.md) * [Get audit history](https://techdocs.akamai.com/property-mgr/reference/get-hostname-audit-history.md)