# Common error messages

> A quick reference for error messages you may see in AgentSky.

canonical: https://agentsky.dev/help/common-errors
source: https://agentsky.dev/help/common-errors.md
updated: 2026-10-22

---

**A quick reference for error messages you may see in AgentSky.**

| Error | What it means | What to do |
|---|---|---|
| `workspace_wallet_empty` | Your workspace has no credits. New chats cannot start. | Add credits in Settings › Team › Billing. |
| `subscription_exhausted` | Your connected Claude or ChatGPT plan is out of allowance for this period. | Top up with AgentSky credits, or wait for your plan to renew. |
| Agent is starting up | The agent pod is warming up — this takes a few seconds on the first turn. | Wait a moment; the agent will respond shortly. |
| Refused | The request was declined (content policy or capability limit). | Edit your message and try again — the error clears automatically when you change the text. |
| Sync paused | Mac-to-workspace sync stopped. | See [Local sync is paused](https://agentsky.dev/help/sync-paused). |
| Out of subscription quota | The connected subscription is fully used. | Switch to credits or reconnect a fresh subscription. |

**API error codes:**

| Code | Meaning |
|---|---|
| 401 | Missing or invalid API key |
| 402 | Insufficient balance |
| 429 | Rate limit exceeded — retry after a short delay |
| 503 | Agent is provisioning — retry |

Where: web, Mac, API

**Good to know:** If an error is not listed here, the message itself usually explains the problem. Copy it and search the help center, or send it to support@agentsky.dev. Related: [I'm out of credits](https://agentsky.dev/help/out-of-credits), [I can't sign in](https://agentsky.dev/help/sign-in-problems), [Local sync is paused](https://agentsky.dev/help/sync-paused).