Alexa.Business.ErrorResponse Interface

If Alexa sends an Alexa.Business directive to your skill and you can't handle it successfully, respond with an Alexa.Business.ErrorResponse event. For an overview of the Alexa.Business interface, see Understand Alexa for Business.

Error response event

In the payload for the Alexa.Business.ErrorResponse, specify the type of the error and include a message with information about the error. For the list of Alexa.Business error types, see Error type values.

ErrorResponse event payload details

Field Description Type Required
type The type of error. String Yes
message The error message for the error. String Yes

ErrorResponse event format

"event": {
    "header": {
      "namespace": "Alexa.Business",
      "name": "ErrorResponse",
      "messageId": "<message id>",
      "payloadVersion": "1.0"
    "payload": {
      "type": "<error type>",
      "message": "<error message>"

Error type values

The following table shows the valid Alexa.Business error types.

Type Description
RESERVATION_ALREADY_EXISTS Indicates that a reservation already exists for the requested meeting time.
RESERVATION_NOT_ALLOWED Indicates that the room does not allow the reservation. Reservations for the room might be restricted.
RESERVATION_NOT_FOUND Indicates that the reservation can't be found.
RESERVATION_OUTSIDE_BUSINESS_HOURS Indicates that the requested meeting time is outside of the normal business hours.
RESERVATION_TOO_FAR_IN_ADVANCE Indicates that the requested meeting time is too far into the future.
RESERVATION_TOO_LONG Indicates that the requested meeting duration is too long.
RESERVATION_TOO_SHORT Indicates that the requested meeting duration is too short.
RESOURCE_NOT_AVAILABLE Indicates that the requested room is unavailable.
RESOURCE_NOT_FOUND Indicates that the requested room does not exist. The room may have existed previously and been deleted, or the room id might be misconfigured.
UNSUPPORTED_OPERATION Indicates that the action requested by the user is not supported by the skill.

In addition to the Alexa.Business error types, you can also use Alexa error types. For more information, see Alexa.ErrorResponse error type values.

The following list shows some Alexa error types that you can use in an Alexa.Business.ErrorResponse event:

Interface Description
Alexa.ErrorResponse Defines general errors for Alexa skills.