Alexa Interface

The Alexa interface is the top-level interface for Alexa skills. For the full list of Alexa capability interfaces, see List of Capability Interfaces and Supported Locales.

The Alexa interface contains general Alexa directives, response events, discovery, state reporting, change reporting, and error reporting. For more information, see Capability Interface Message Guide.

Discovery

You should explicitly include the Alexa interface in the Discover.Response for your skills. For more information about discovery, see Alexa.Discovery Interface.

The following example shows a Discover.Response message for an endpoint that supports the Alexa.PowerController and Alexa interfaces. For more discovery examples, see the documentation for each interface.

{
  "event": {
    "header": {
      "namespace": "Alexa.Discovery",
      "name": "Discover.Response",
      "payloadVersion": "3",
      "messageId": "<message id>"
    },
    "payload": {
      "endpoints":[
        {
          "endpointId": "<unique ID of the endpoint>",
          "manufacturerName": "<the manufacturer name of the endpoint>",
          "description": "<a description that is shown in the Alexa app>",
          "friendlyName": "<device name, displayed in the Alexa app>",
          "displayCategories": ["LIGHT"],
          "cookie": {},
          "capabilities": [
            {
              "type": "AlexaInterface",
              "interface": "Alexa.PowerController",
              "version": "3",
              "properties": {
                "supported": [
                  {
                    "name": "powerState"
                  }
                ],
                "proactivelyReported": true,
                "retrievable": true
              }
            },
            {
              "type": "AlexaInterface",
              "interface": "Alexa",
              "version": "3"
            }
          ]
        }
      ]
    }
  }
}