Troubleshooting

Something not working as expected? Start with the known failure patterns below and move into the linked runbook when the issue needs an operational response.

Common Error Codes

RATE_LIMIT_EXCEEDED
Guide

Stabilize traffic when clients or connectors exceed current request or token budgets.

Open resolution guide
CONNECTOR_AUTH_FAILED
Guide

Recover from expired grants, invalid scopes, or revoked third-party app access.

Open resolution guide
GRAPH_DEADLOCK_DETECTED
Guide

Identify cyclic state transitions or missing terminal states in workflow graphs.

Open resolution guide
REGIONAL_LATENCY_HIGH
Guide

Bring regional latency back under control during edge saturation or uneven rollout distribution.

Open resolution guide

Linked runbooks

troubleshooting

Fixing Connector Auth Failures

Restore OAuth-backed connectors such as Gmail, Slack, or Salesforce without losing downstream workflow state.

Open runbook

troubleshooting

Debugging Agent Graph Deadlocks

Break and prevent execution loops or unreachable states in complex multi-step agent workflows.

Open runbook

scaling

Scaling Regional Edge Capacity

Increase regional capacity when latency, queue depth, or error rates indicate a localized traffic surge.

Open runbook

Still need help?

If the documented fix path does not resolve the issue, escalate with the guide ID, request ID, and related runbook attached.