---
canonical: "https://agi-labo.com/en/tools/wings/docs/error-codes"
title: "Error codes"
description: "Common codes and the action to take next."
section: "Reference"
order: 20
pageType: "reference"
lastVerifiedVersion: "1.4.16"
lastVerifiedAt: "2026-10-15"
draft: false
surfaces: ["cli", "console", "api"]
plans: ["free", "member"]
---

Read the HTTP status and message alongside the error code.
`reason` explains the cause, and `scope` identifies the limit.
If `retryAfterSeconds` is present, wait that many seconds before trying again.

## Common errors

| Code | What happened and what to do |
| --- | --- |
| `rate_limited` | A rate or time limit was reached. Check `scope` and the retry time. |
| `handler_limit_exceeded` | You reached the Handler count limit. Remove an unused Handler. |
| `trigger_limit_exceeded` / `trigger_total_limit_exceeded` / `web_app_limit_exceeded` | You reached a per-Handler, total, or Web App creation limit. Remove an unused resource. |
| `schedule_rate_limit_exceeded` | Enabled Schedules exceed the combined hourly limit. Increase their intervals. |
| `db_sql_forbidden` | The SQL is unsupported. Follow the `reason` and suggested alternative. |
| `db_storage_limit_exceeded` | The write would exceed storage capacity. Reduce the stored data. |
| `db_read_quota_exceeded` / `db_write_quota_exceeded` | You reached a scan or write limit. Writes may also be restricted after a downgrade. |
| `db_time_quota_exceeded` | `busy` means waiting for another operation; `paused` means a temporary pause. Wait for `retryAfterSeconds`. |
| `db_run_not_running` | A Database call happened after its Run ended. Finish the work inside the Run. |
| `route_not_found` | The URL is unknown, disabled, revoked, or unauthorized. Check the URL and settings. |
| `sharing_unavailable` | Adding people to shared apps is unavailable. You can still list and remove them. |
| `share_limit_app` / `share_limit_account` / `share_limit_daily` | You reached a sharing limit or an addition limit for the last 24 hours. Check the shared people and limits. |
| `share_owner_email` | The invitation is for the owner. Check the recipient's email address. |
| `web_app_locked` | The operator stopped the app. Contact support. |
| `account_suspended` | The account is suspended. Reads and deletion remain available. |
| `wings_runtime_paused` | The operator temporarily paused execution. |
| `redirect_not_allowed` | A redirect points to another origin. Keep the redirect on the same origin. |
| `invalid_secret_name` | The Secret name is reserved, for example `WINGS_`. Choose another name. |
| `handler_payload_too_large` / `handler_result_too_large` | The event or result exceeds a JSON limit. Reduce its content. |

## Schedule outcomes

| Reason | What happened |
| --- | --- |
| `superseded_by_next_occurrence` | The next occurrence took priority, so this one was skipped. |
| `external_outcome_unknown` | Execution started, but the external result is unknown. |
| `retry_exhausted` | All attempts before execution were used up. |
| `queue_delivery_exhausted` | All queue delivery attempts were used up. |

A Handler error needs a different response from an HTTP error returned before execution.
Read [Troubleshooting](/en/tools/wings/docs/troubleshooting) before retrying.