Troubleshooting

"401 unauthorized"

Your token expired or was revoked. Run qs login again or rotate the key in the dashboard.

"402 quota_exhausted"

You've used your monthly quacks. Upgrade your plan or wait for the next cycle. Check usage with:

bashqs usage

"429 rate_limited"

Slow down and retry with exponential backoff and jitter. SDKs do this automatically.

Streaming hangs in production

Check that your reverse proxy isn't buffering Server-Sent Events. For nginx add:

nginxproxy_buffering off;
proxy_cache off;
proxy_set_header X-Accel-Buffering no;

CLI panic: "no .quackstack.toml found"

Run qs init in your project root.

VS Code: extension can't connect

Most often a corporate proxy. Set http.proxy in VS Code settings and restart.

Still stuck?

Open a ticket at our support center or email [email protected].