Troubleshooting

Common issues, error messages, and how to resolve them.

Common issues#

"Model configuration required"#

Cause: Managed inference is unavailable for the workspace and no bring your own model key is configured.

Fix: Ask an admin to enable managed access for the workspace or go to Settings → Model Configuration and add your own provider key.

"Connection expired"#

Cause: The OAuth token for a connected service has expired.

Fix: Go to Settings → Connections, find the affected service, and click Reconnect to re-authenticate.

"Action blocked by governance"#

Cause: A governance rule is preventing the action.

Fix: Review your rules in Settings → Governance. Either modify the rule or manually approve the specific action.

"Budget exceeded"#

Cause: Your workspace has hit its monthly spending limit.

Fix: Increase the budget in Settings → Billing or wait for the next billing cycle.

Error codes#

CodeMeaningResolution
E001Invalid API keyCheck your workspace token
E002Provider errorCheck your LLM provider status
E003Rate limitedWait and retry (see Retry-After header)
E004Governance blockReview governance rules
E005Connection failedReconnect the affected service
E006Budget exceededIncrease budget or wait for reset

Getting help#

If you're stuck:

  1. Check this troubleshooting guide
  2. Search the docs for your specific issue
  3. Contact support at hello@hellm.ai

success Include your workspace ID and the error code when contacting support — it helps us resolve issues faster.