Skill Enablement

This API is used to enable custom skills programmatically, rather than from the developer portal. The developer can interact with the enablement as with other sub-resources. 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.

Enable a skill

Enables a skill stage for the requestor. The requestor should be either a developer or the owner of the skill. Please note that only one skill stage can be enabled for a given user at one time. If another stage of a skill is already enabled for the requestor, this API will return HTTP/1.1 403 Forbidden response.

Request

PUT /v1/skills/{skillId}/stages/{stageName}/enablement

Parameters

FieldDescriptionParameter TypeRequired
skillIdUnique identifier of skill.PathYes
stageIndicates stage of the skill. Accepted value is development (case sensitive).PathYes

Response

HTTP/1.1 204 No Content

Exceptions

HTTP/1.1 401 Unauthorized
HTTP/1.1 403 Forbidden
HTTP/1.1 404 Not Found
HTTP/1.1 409 Conflict
HTTP/1.1 500 Internal Service Error
HTTP/1.1 503 Service Unavailable

Check enablement status of a skill

Checks whether a skill stage is enabled or not for the requestor. It returns 204 if the skill stage is enabled, and 404 otherwise.

Request

GET /v1/skills/{skillId}/stages/{stageName}/enablement
FieldDescriptionParameter TypeRequired
skillIdUnique identifier of skill.PathYes
stageIndicates stage of the skill. Accepted value is development (case sensitive).PathYes

Response

HTTP/1.1 204 No Content

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 Service Error
HTTP/1.1 503 Service Unavailable

Disable a skill

Disables a skill by deleting the skill enablement. If no skill enablement exists, then the skill must be enabled through the developer portal, unless another skill enablement is created.

Request

DELETE /v1/skills/{skillId}/stages/{stageName}/enablement
FieldDescriptionParameter TypeRequired
skillIdUnique identifier of skill.PathYes
stageIndicates stage of the skill. Accepted value is development (case sensitive).PathYes

Response

HTTP/1.1 204 No Content

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 Service Error
HTTP/1.1 503 Service Unavailable