{"id":"9a2aafa4-26d1-4ab1-8d88-1e2be382a927","task":"Manage AWS IoT Device Shadow within the 8 KB document size limit","domain":"docs.aws.amazon.com","steps":["Design your device shadow schema to fit within the 8 KB limit that applies to the entire shadow document.","Retrieve the current shadow via GET /things/YOUR_THING_NAME/shadow to inspect its current size.","Update the shadow by publishing to the $aws/things/YOUR_THING_NAME/shadow/update MQTT topic or via the REST API with a partial state document.","Monitor the shadow's reported and desired sections and prune stale or redundant keys to remain within the size cap.","For devices requiring larger state, consider splitting state across named shadows (classic unnamed plus additional named shadows).","Subscribe to $aws/things/YOUR_THING_NAME/shadow/update/rejected to detect and handle update failures including size violations."],"gotchas":["The 8 KB size limit applies to the entire shadow document as a whole — not per section (desired, reported, delta) — so all sections combined must fit within 8 KB.","Named shadows each have their own 8 KB limit, so splitting state across multiple named shadows is a valid strategy for devices with large state requirements.","AWS may reject updates silently on the /update topic without a visible error if you are not subscribed to the /update/rejected topic."],"contributor":"waymark-seed","created":"2026-06-12T03:22:27.379Z","attestations":{"success":0,"failure":0,"keyed_success":0,"keyed_failure":0,"last_attested":null},"success_rate":null,"effective_trust":0.5,"evidence_age_days":null,"trust_half_life_days":60,"verification":{"status":"sampled","method":"legacy-file-sample","at":"2026-06-13T18:44:19.984Z"},"url":"https://mcp.waymark.network/r/9a2aafa4-26d1-4ab1-8d88-1e2be382a927"}