---
canonical: "https://agi-labo.com/tools/wings/docs/error-codes"
title: "エラーコード"
description: "よくあるコードと次に取る操作を確認します。"
section: "リファレンス"
order: 20
pageType: "reference"
lastVerifiedVersion: "1.4.16"
lastVerifiedAt: "2026-10-15"
draft: false
surfaces: ["cli", "console", "api"]
plans: ["free", "member"]
---

エラーのコードと一緒に、HTTP ステータスやメッセージを確認してください。
`reason` は理由、`scope` は上限の種類です。
`retryAfterSeconds` がある場合は、その秒数を待ってから試します。

## よくあるエラー

| コード | 起きたことと次の操作 |
| --- | --- |
| `rate_limited` | 回数や時間の上限です。`scope` と再開時刻を確認してください。 |
| `handler_limit_exceeded` | Handler 数の上限です。不要な Handler を削除してください。 |
| `trigger_limit_exceeded` / `trigger_total_limit_exceeded` / `web_app_limit_exceeded` | Handler ごと、全体、Web アプリの作成上限です。不要なものを削除してください。 |
| `schedule_rate_limit_exceeded` | 有効な Schedule の毎時合計が上限を超えています。間隔を延ばしてください。 |
| `db_sql_forbidden` | 対応していない SQL です。`reason` と提案に従って直してください。 |
| `db_storage_limit_exceeded` | 書き込むと容量の上限を超えます。データを整理してください。 |
| `db_read_quota_exceeded` / `db_write_quota_exceeded` | 走査・書き込みの上限です。プラン変更後は書き込みが制限される場合もあります。 |
| `db_time_quota_exceeded` | `busy` は順番待ち、`paused` は一時停止です。`retryAfterSeconds` の秒数を待ってください。 |
| `db_run_not_running` | Run の終了後に DB を操作しようとしました。Run 内で処理を終えてください。 |
| `route_not_found` | URL が不明、無効、失効済み、または権限がありません。URL と設定を確認してください。 |
| `sharing_unavailable` | 共有相手の追加が使えません。一覧の確認と削除はできます。 |
| `share_limit_app` / `share_limit_account` / `share_limit_daily` | 共有人数や直近24時間の追加数の上限です。共有相手と上限を確認してください。 |
| `share_owner_email` | 所有者本人を招待しています。共有相手のメールアドレスを確認してください。 |
| `web_app_locked` | 運営がアプリを停止しています。サポートに連絡してください。 |
| `account_suspended` | アカウントが停止されています。読み取り・削除はできます。 |
| `wings_runtime_paused` | 運営が実行を一時停止しています。 |
| `redirect_not_allowed` | 別 origin へ転送しています。同じ origin 内の転送に直してください。 |
| `invalid_secret_name` | `WINGS_` などの予約された名前です。Secret 名を変えてください。 |
| `handler_payload_too_large` / `handler_result_too_large` | event または結果が JSON の上限を超えています。内容を減らしてください。 |

## Schedule の終了理由

| 理由 | 起きたこと |
| --- | --- |
| `superseded_by_next_occurrence` | 次の回を優先し、この回を飛ばしました。 |
| `external_outcome_unknown` | 実行後、外部の結果が分からなくなりました。 |
| `retry_exhausted` | 開始前の再試行を使い切りました。 |
| `queue_delivery_exhausted` | キューからの配信を使い切りました。 |

Handler が投げたエラーと、実行前に返された HTTP エラーでは対処が異なります。
やり直す前に、[エラーと対処](/tools/wings/docs/troubleshooting)を確認してください。
