Skip to content

Error codes

Common codes and the action to take next.

Applies to
CLIConsoleAPI

Verified · v1.4.16

Markdown

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 before retrying.