Alexa Skill Credentials API

The Alexa Skill Credentials API returns the client credentials, in particular the clientId and clientSecret for the skill. These credentials can be used to get the customer authentication token that can be used to get the access token from the Skill Messaging API.

The workflow is as follows:

• The skill service code calls LWA to get the access token.

• This token is then used to authorize the calls to the SMAPI APIs.

• After authorization, the SMAPI API returns the client credentials for a particular skillId. The response contains the skillMessagingCredentials which are used by the skill to get the customer authentication token which then enables the skill to access the approved permissions.

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.

• GET
  • Request
    • Request headers
    • Request body
  • Response
    • Response header
    • Response body
  • Error response handling–Status codes

GET

Obtain the skill credentials for the specified skill.

HTTP/1.1

GET /v1/skills/{skillId}/credentials 

Request

Request headers

  Content-Type: application/json
  Accept: application/json
  Authorization: string

Request body

Empty body.

Response

Response header

Content-Type: application/json
X-Amzn-RequestId: string
X-Amzn-Authorization: string

Response body

{
  "skillMessagingCredentials": {
    "clientId": "<String>",
    "clientSecret": "<String>"
  }
}

Error response handling–Status codes