Skill Certification, v0


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 (ASK CLI) Overview

Submit a skill for certification

Submit a skill for certification for potential publication.

Request

POST /v0/skills/{skillId}/stages/certification
Field Description Parameter Type Required?
skillId 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/{skillId}/withdraw

Body

{
  "reason" : "MORE_FEATURES",
  "message" : ""
}
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 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.


Was this page helpful?

Last updated: Mar 30, 2022