Reference
Widget errors
Meanings and remedies for public widget errors.
Error reference
| Code | Meaning | What to do |
|---|---|---|
| unknown_workspace | The workspace key does not exist. | Copy the key from Widget → Installation. |
| origin_not_allowed | The current origin is not allowlisted. | Add the exact protocol and host in Widget → Installation. |
| invalid_input | A command payload is malformed or too large. | Compare the payload with the SDK reference. |
| invalid_session | The anonymous session is missing or expired. | Reload the host page to start a fresh session. |
| signed_identity_required | This workspace runs in strict mode and only accepts verified identity. | Send a fresh server-signed token with identify. |
| invalid_identity_token | The identity token is invalid, expired or already used. | Generate a new token with the correct audience, expiry and jti. |
| rate_limited | Too many requests were sent in a short period. | Respect Retry-After and reduce repeated calls. |