Alexa.Commissionable.ReportCommissioningInformation.ErrorResponse Interface 1.0

If Alexa sends an Alexa.Commissionable.ReportCommissioningInformation directive to your smart home add-on and you can’t handle it successfully, respond with an ReportCommissioningInformation.ErrorResponse event. For details, see Alexa.Commissionable Interface.

ErrorResponse event

In the payload for the ReportCommissioningInformation.ErrorResponse, specify the type of the error and include a message with information about the error. For the list of ReportCommissioningInformation error types, see Error type values. You can send the error response in a synchronous or asynchronous response. For more details, see Alexa.ErrorResponse.

ReportCommissioningInformation.ErrorResponse payload properties

The following table shows the error response payload for Alexa.Commissionable.ReportCommissioningInformation.

Property	Description	Type	Required
`type`	Error type values encountered by the add-on when trying to return commissioning information.	String	Yes
`message`	Error description.	String	No

ErrorResponse event format

{
    "event": {
        "header": {
            "namespace": "Alexa.Commissionable",
            "name": "ReportCommissioningInformation.ErrorResponse",
            "messageId": "Unique identifier, preferably a version 4 UUID",
            "payloadVersion": "1.0"
        },
        "endpoint": {
            "endpointId": "Endpoint id"
        },
        "payload": {
            "type": "error type",
            "message": "error message"
        }
    }
}

Error type values

The following table shows the valid Alexa.Commissionable.ReportCommissioningInformation error types.

Value	Description
`MAX_COMMISSIONING_LIMIT_REACHED`	Endpoint was already commissioned with the maximum number of local hubs.
`FAILED_TO_BOOTSTRAP_COMMISSIONING_PROCESS`	Endpoint is reachable but is unable to accept local connection. For Matter, it might mean that the endpoint failed to put the device into commissioning mode.

In addition to the ReportCommissioningInformation error types, you can use standard Alexa error types, such as ENDPOINT_BUSY, ENDPOINT_UNREACHABLE, and BRIDGE_UNREACHABLE. For details, see Alexa ErrorResponse event Error type values.

Alexa.Commissionable.ReportCommissioningInformation.ErrorResponse examples

The following examples show the payload for different error types.

MAX_COMMISSIONING_LIMIT_REACHED

The following is an example error response for the MAX_COMMISSIONING_LIMIT_REACHED error type.

{
  "event": {
    "header": {
      "namespace": "Alexa.Commissionable",
      "name": "ReportCommissioningInformation.ErrorResponse",
      "messageId": "Unique identifier, preferably a version 4 UUID",
      "correlationToken": "Opaque correlation token that matches the request",
      "payloadVersion": "1.0"
    },
    "endpoint":{
      "endpointId": "unique endpoint id"
    },
    "payload": {
      "type": "MAX_COMMISSIONING_LIMIT_REACHED",
      "message": "Endpoint was already commissioned with the maximum number of local hubs."
    }
  }
}

Get Started

Connect Your Device to Alexa

Certify Your Device

Developer Reference

Alexa.Commissionable.ReportCommissioningInformation.ErrorResponse Interface 1.0

ErrorResponse event

ReportCommissioningInformation.ErrorResponse payload properties

ErrorResponse event format

Error type values

Alexa.Commissionable.ReportCommissioningInformation.ErrorResponse examples

MAX_COMMISSIONING_LIMIT_REACHED

​ErrorResponse event

​ReportCommissioningInformation.ErrorResponse payload properties

​ErrorResponse event format

​Error type values

​Alexa.Commissionable.ReportCommissioningInformation.ErrorResponse examples

​MAX_COMMISSIONING_LIMIT_REACHED

​Related topics

ErrorResponse event

ReportCommissioningInformation.ErrorResponse payload properties

ErrorResponse event format

Error type values

Alexa.Commissionable.ReportCommissioningInformation.ErrorResponse examples

MAX_COMMISSIONING_LIMIT_REACHED

Related topics