Skill Certification

This document describes API operations related to the certification of a skill. The API's endpoint is https://api.amazonalexa.com. Each API 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 and Alexa Skill Validation API

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