Skill Certification Operations (Skill Management API)
This document describes API operations related to the certification of a skill. Each request must have an Authorization header whose value should be the access token retrieved from Login with Amazon.
See also: Alexa Skills Kit Command Line Interface and Alexa Skill Management API Overview
Submit a skill for certification
Submit a skill for certification for potential publication.
Request
POST /v1/skills/{skillId}/submit
Parameter Description
| Field | Description | Parameter Type | Required? |
|---|---|---|---|
| skillId | Unique identifier of skill. | Path | Yes |
Response
HTTP/1.1 202 Accepted
Headers
Location: "<relative path to track submission status>"
Exceptions
HTTP/1.1 401 Unauthorized
HTTP/1.1 403 Forbidden
HTTP/1.1 404 Not Found
HTTP/1.1 429 Too Many Requests
HTTP/1.1 500 Internal Server Error
HTTP/1.1 503 Service Unavailable
Withdraw a skill from certification
Withdraw a skill from the certification process.
Request
POST /v1/skills/{skillId}/withdraw
Body
{
"reason" : "OTHER",
"message" : "TEST SKILL"
}
Parameter Description
| Field | Description | Parameter Type | Required? |
|---|---|---|---|
| skillId | Unique identifier of skill. | Path | Yes |
| reason | One of the following enum values indicating the reason for the withdrawal: TEST_SKILL, MORE_FEATURES, DISCOVERED_ISSUE, NOT_RECEIVED_CERTIFICATION_FEEDBACK, NOT_INTEND_TO_PUBLISH, OTHER |
Request Body Element | Yes |
| message | String that indicates why the skill is being withdrawn, when OTHER is specified as a reason. |
Request Body Element | Yes, for reason OTHER, otherwise no. |
Response
HTTP/1.1 204 No Content
Exceptions
HTTP/1.1 400 Bad Request
HTTP/1.1 401 Unauthorized
HTTP/1.1 403 Forbidden
HTTP/1.1 404 Not Found
HTTP/1.1 429 Too Many Requests
HTTP/1.1 500 Internal Server Error
HTTP/1.1 503 Service Unavailable