Error code format#
LumenFlow errors follow the format EXXXX with a human-readable
message and additional context for debugging.
Authentication errors (E001-E009)#
| Code | Message | Resolution |
|---|---|---|
E001 | Invalid API key | Check your workspace token in Settings |
E002 | Token expired | Generate a new token |
E003 | Insufficient scope | Request the needed scope when creating the token |
E004 | Session expired | Sign in again |
Provider errors (E010-E019)#
| Code | Message | Resolution |
|---|---|---|
E010 | Provider unavailable | Check your LLM provider's status page |
E011 | Invalid provider key | Verify your API key with the provider |
E012 | Provider rate limited | Wait and retry; consider a different model |
E013 | Model not available | Choose a different model in settings |
Governance errors (E020-E029)#
| Code | Message | Resolution |
|---|---|---|
E020 | Action blocked by rule | Review governance rules in settings |
E021 | Approval required | Approve the pending proposal |
E022 | Escalation needed | Route to the designated approver |
E023 | Policy conflict | Two rules conflict — adjust priorities |
Budget errors (E030-E039)#
| Code | Message | Resolution |
|---|---|---|
E030 | Budget exceeded | Increase budget or wait for reset |
E031 | Per-action limit exceeded | Simplify the request or raise the limit |
E032 | Daily action limit reached | Wait until tomorrow or raise the limit |
Connection errors (E040-E049)#
| Code | Message | Resolution |
|---|---|---|
E040 | Connection not found | Add the connection in settings |
E041 | Connection expired | Reconnect via OAuth |
E042 | Insufficient permissions | Re-authorize with required scopes |
E043 | Service unreachable | Check the external service's status |
success Include the error code and
detailsfield when contacting support. This helps us diagnose issues quickly.