Troubleshooting
Common situations.
Most "errors" are normal states. Here's how to read them.
| Symptom | What it means & what to do |
|---|---|
Asked to sign in repeatedly / 401 | The token expired or you're not authenticated yet. Complete the OAuth sign-in (or check the Authorization header). The server returns a pointer to its authorization server so compliant clients can re-auth automatically. |
live: false with empty tags | No Desktop Companion App is streaming that project right now. This is a normal success, not an error — start a DCA session to see live values. |
Analysis / export stuck at queued / running | The async job is still working. Poll plcs_get_analysis / plcs_get_export until complete. Normal progress, not a failure. |
Too-large error on plcs_get_project_source | The parsed view exceeds the inline ceiling on a big project. Retry with format: "raw". |
403 naming a missing scope | Your credential lacks that permission. Add it to the key (or your membership) — see Permissions. |
project_scope_forbidden | The credential is restricted to other projects; that project is out of scope. |
| Spend-limit error on a billable tool | The organization is paused at its API spend cap. Raise it in Settings; don't retry automatically. |
Every failure carries a stable error code and a unique request id. Quote the request id when contacting support.