| 400 | invalid_grant | Code or refresh token is used, expired, or revoked. Reconnect |
| 400 | invalid_grant + refresh_race | Another request just refreshed. Use the tokens it saved |
| 400 | invalid_target | Child token asked for a model or thinking level the grant can’t serve |
| 400 | invalid_request | Fix the request |
| 400 | thinking_level_unavailable | Model doesn’t offer that thinking level |
| 401 | invalid_client | Wrong client ID or secret |
| 401 | link_token_expired | Refresh and retry (linkFetch does this) |
| 401 | grant_revoked | User disconnected. Show Reconnect |
| 403 | permission_denied | Child tokens can’t read grants or usage |
| 424 | model_not_granted | User’s plans can’t serve that model. Check GET /v1/models |
| 424 | subscription_exhausted | Plans at their limit. Wait for resets_at |
| 424 | grant_budget_exhausted | Used the user’s token cap for your app. Wait for resets_at |
| 424 | subscription_client_mismatch | Plan only serves Claude Code or Muse Code. Ask for another plan |
| 5xx | link_request_failed | Retry. Report the request_id |