Skill Enablement
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.
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