Select your cookie preferences

We use essential cookies and similar tools that are necessary to provide our site and services. We use performance cookies to collect anonymous statistics, so we can understand how customers use our site and make improvements. Essential cookies cannot be deactivated, but you can choose “Customize” or “Decline” to decline performance cookies.

If you agree, AWS and approved third parties will also use cookies to provide useful site features, remember your preferences, and display relevant content, including relevant advertising. To accept or decline all non-essential cookies, choose “Accept” or “Decline.” To make more detailed choices, choose “Customize.”

Device Shadow error messages

Focus mode
Device Shadow error messages - AWS IoT Core

The Device Shadow service publishes a message on the error topic (over MQTT) when an attempt to change the state document fails. This message is only emitted as a response to a publish request on one of the reserved $aws topics. If the client updates the document using the REST API, then it receives the HTTP error code as part of its response, and no MQTT error messages are emitted.

HTTP error code Error messages
400 (Bad Request)
  • Invalid JSON

  • Missing required node: state

  • State node must be an object

  • Desired node must be an object

  • Reported node must be an object

  • Invalid version

  • Invalid clientToken

    Note

    A client token that is longer than 64 bytes will cause this response.

  • JSON contains too many levels of nesting; maximum is 6

  • State contains an invalid node

401 (Unauthorized)
  • Unauthorized

403 (Forbidden)
  • Forbidden

404 (Not Found)
  • Thing not found

  • No shadow exists with name: shadowName

409 (Conflict)
  • Version conflict

413 (Payload Too Large)
  • The payload exceeds the maximum size allowed

415 (Unsupported Media Type)
  • Unsupported documented encoding; supported encoding is UTF-8

429 (Too Many Requests)
  • The Device Shadow service will generate this error message when there are more than 10 in-flight requests on a single connection. An in-flight request is an in-progress request that has been started but not yet completed.

500 (Internal Server Error)
  • Internal service failure

PrivacySite termsCookie preferences
© 2025, Amazon Web Services, Inc. or its affiliates. All rights reserved.