Your Alexa Dashboards Settings

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 /v0/skills/{skill_id}/submit
Field Description Parameter Type Required?
skill_id Unique identifier of skill. Path Yes

Response

HTTP/1.1 202 Accepted
HTTP/1.1 400

Server cannot process the request due to a client error. For example, the skill is not valid for submission.

HTTP/1.1 401 

Unauthorized.

HTTP/1.1 404 

The specified skill does not exist.

Withdraw a skill from certification

Withdraw a skill from the certification process.

Request

POST /v0/skills/{skill_id}/withdraw

Body

{
  "reason" : "MORE_FEATURES",
  "message" : ""
}
Field Description Parameter Type Required?
skill_id 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 OTHER, otherwise no.

Response

HTTP/1.1 204 

Success.

HTTP/1.1 400 

Server cannot process the request due to a client error. For example, the skill is not in a submission state.

HTTP/1.1 401 

Unauthorized.

HTTP/1.1 404 

The specified skill doesn’t exist.