Skill Enablement

Note: Watch the replay of Alexa Live ‘22 on demand. Catch the latest on ambient intelligence, smart home, and AI.

You use this API to enable custom skills programmatically, rather than from the developer portal. If you want to enable skills for other users, you can set up app-to-app account linking and use the Alexa Skill Activation API.

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.

Note: This API is only available for custom skills and knowledge skills.

Enable a skill
Check enablement status of a skill
Disable a skill

Enable a skill

Enables a skill stage for the requestor. The requestor should be either a developer or the owner of the skill. Only a single 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 automatically disable the stage that has already been enabled and enable the stage input value in the request.

Request

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

Parameters

Field	Description	Parameter Type	Required
`skillId`	Unique identifier of skill.	Path	Yes
`stage`	Indicates stage of the skill. One of: `development`, `live`.	Path	Yes

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

Field	Description	Parameter Type	Required
`skillId`	Unique identifier of skill.	Path	Yes
`stage`	Indicates stage of the skill. One of: `development`, `live`.	Path	Yes

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

Field	Description	Parameter Type	Required
`skillId`	Unique identifier of skill.	Path	Yes
`stage`	Indicates stage of the skill. One of:`development`, `live`.	Path	Yes

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