# IglooHome Error and Warning Codes

### Overview

IglooHome devices can generate errors and warnings related to device connectivity, bridge status, and access code management. Understanding these codes helps you quickly diagnose and resolve issues.

{% hint style="info" %}
**Note:** Error and warning codes may change over time as we improve our error handling. Use these codes as a reference for troubleshooting, but avoid building logic that depends on specific code keys remaining static.
{% endhint %}

### Device Errors

Device errors indicate critical issues that prevent normal operation.

| Error Code            | Description                             | Triggered When                                   | Resolution                                                                                       |
| --------------------- | --------------------------------------- | ------------------------------------------------ | ------------------------------------------------------------------------------------------------ |
| `device_disconnected` | Device is offline and cannot be reached | Device goes offline (not an offline-only device) | Reconnect the device through the Igloohome app. Check device batteries and network connectivity. |
| `hub_disconnected`    | The Igloohome Bridge is offline         | Bridge cannot communicate with the cloud         | Check bridge power and network connection. Restart the bridge if needed.                         |

### Device Warnings

Device warnings indicate potential issues or configuration limitations but don't prevent all functionality.

| Warning Code                              | Description                                            | Triggered When                                            | Impact                                                                                                 |
| ----------------------------------------- | ------------------------------------------------------ | --------------------------------------------------------- | ------------------------------------------------------------------------------------------------------ |
| `accessory_keypad_setup_required`         | Accessory keypad is not linked to the Igloohome Bridge | Device has both keypad and bridge, but they're not linked | Online access code programming will fail. Link the keypad to the bridge in the Igloohome app.          |
| `hub_required_for_addtional_capabilities` | Device is operating without an Igloohome Bridge        | Device has no bridge configured                           | Only offline access codes are available. Add a bridge to enable remote unlock and online access codes. |
| `device_has_flaky_connection`             | Device has an unstable internet connection             | Frequent network disconnections detected                  | May experience intermittent issues with remote operations.                                             |

{% hint style="info" %}
**Note:** The legacy warning `functional_offline_device` is being migrated to `hub_required_for_addtional_capabilities`.
{% endhint %}

### Access Code Errors

Access code errors prevent the creation or management of access codes.

| Error Code                               | Description                 | Triggered When                                                   | Resolution                                                                                                                |
| ---------------------------------------- | --------------------------- | ---------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------- |
| `igloohome_bridge_too_many_pending_jobs` | Bridge queue is at capacity | Bridge has 20 or more pending jobs                               | Seam will continue retrying automatically. If the issue persists, contact support. Jobs will process as the queue clears. |
| `igloohome_bridge_offline`               | Bridge cannot be contacted  | Bridge reports that it's offline or lock is not linked to bridge | Verify the bridge is online and the lock i                                                                                |


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.seam.co/latest/device-and-system-integration-guides/igloohome-locks/igloohome-error-and-warning-codes.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.