Error Code Reference

Complete reference of LumenFlow error codes with causes and resolutions.

Error code format#

LumenFlow errors follow the format EXXXX with a human-readable message and additional context for debugging.

Authentication errors (E001-E009)#

CodeMessageResolution
E001Invalid API keyCheck your workspace token in Settings
E002Token expiredGenerate a new token
E003Insufficient scopeRequest the needed scope when creating the token
E004Session expiredSign in again

Provider errors (E010-E019)#

CodeMessageResolution
E010Provider unavailableCheck your LLM provider's status page
E011Invalid provider keyVerify your API key with the provider
E012Provider rate limitedWait and retry; consider a different model
E013Model not availableChoose a different model in settings

Governance errors (E020-E029)#

CodeMessageResolution
E020Action blocked by ruleReview governance rules in settings
E021Approval requiredApprove the pending proposal
E022Escalation neededRoute to the designated approver
E023Policy conflictTwo rules conflict — adjust priorities

Budget errors (E030-E039)#

CodeMessageResolution
E030Budget exceededIncrease budget or wait for reset
E031Per-action limit exceededSimplify the request or raise the limit
E032Daily action limit reachedWait until tomorrow or raise the limit

Connection errors (E040-E049)#

CodeMessageResolution
E040Connection not foundAdd the connection in settings
E041Connection expiredReconnect via OAuth
E042Insufficient permissionsRe-authorize with required scopes
E043Service unreachableCheck the external service's status

success Include the error code and details field when contacting support. This helps us diagnose issues quickly.