# エラーコード

> このページでは、ブラウザ RPA のノード実行記録（`nodes.list` / `GET /runs/{id}/nodes` の `error`）、実行結果（`run.error`）、Local API リクエストに現れる可能性があるエラーコードを示します。
Local API で `docs/api/error-codes.md` を読み取ると、リクエストの言語の版が返されます。ルールは `message` と同じです。`Accept-Language` が優先され、ヘッダーがない場合はクライアントの UI 言語が適用されます。サポートされていない言語では en-US が返されます。固定の言語で読み取るには、`error-codes.<language>.md` を使用してください。中国語版は `error-codes.zh-CN.md` です。


## エラーオブジェクト

```json
{"code": "ELEMENT_NOT_FOUND", "message": "No matching element was found. Check that the selector is correct and that the page has finished loading", "retryable": false, "details": {"phase": "selector", "matchedCount": 0}}
```

- `code`：安定したエラーコードです。リカバリーと分岐のロジックは、この値に基づいて組み立ててください。
- `message`：人が読むためのメッセージです。同じエラーに対してクライアントの UI に表示される文と同じです。`Accept-Language` リクエストヘッダーの言語で返され、ヘッダーがない場合はクライアントの UI 言語で返されます。テキストはバージョンや言語によって変わるため、プログラムは `code` と `details` に基づいて判断し、`message` を解析しないでください。以下の表の「説明」列は、各エラーコードの開発者向けの説明です。API が返す `message` ではありません。
- `details`：任意の構造化されたコンテキストで、情報がない場合は `null` です。含まれるのは、以下の表のフィールドだけです。`cause` を除き、生の例外テキスト、URL、セレクター、ローカルパス、ページの内容、非公開の入力が含まれることはありません。`cause` が含まれるのは、`ATOM_FAILED` / `CONTROL_FAILED`（具体的な原因を特定できない場合に使用されるフォールバックエラー）、`CDP_ERROR`（ブラウザがコマンドを拒否した場合）、`SCRIPT_FAILED`（スクリプトが例外をスローした場合）だけです。元の原因テキスト（最大 300 文字の 1 行）が、内容を置き換えずにそのまま格納されます。


| フィールド | 型 | 意味 |
|  --- | --- | --- |
| field | string | エラーの原因となったノード入力フィールド（`selector`、`exception.retryTimes`、`fields[0].key` など） |
| reason | string | `required`（必須の値がない）、`type`（型が誤っている）、`range`（範囲外）、`enum`（許可されていない値）、`format`（形式が無効）、`conflict`（フィールドが競合している）、`limit`（上限を超えた）、`timeout`（タイムアウトした）、`cancelled`（キャンセルされた）、`unknown`（不明なフィールドまたは値）、`duplicate`（重複している）、`empty`（リストまたは内容が空） |
| expected | string | 期待される型：string / number / integer / boolean / object / array / null |
| min / max / limit | number | 範囲の下限、範囲の上限、または件数/バイト数/ミリ秒の上限 |
| httpStatus | number | HTTP ステータスコード |
| netError | string | Chromium のネットワークエラー（`ERR_NAME_NOT_RESOLVED`、`ERR_CONNECTION_REFUSED`、`ERR_BLOCKED_BY_CLIENT` など） |
| systemCode | string | システムのエラーコード（`ENOENT`、`EROFS`、`ECONNREFUSED` など） |
| matchedCount | number | 実際に一致した要素の数 |
| phase | string | 失敗が発生した段階：navigation / selector / script / download / upload / network / file / host / mail / output |
| errorName | string | ユーザースクリプトがスローした標準の例外の型：Error / TypeError / ReferenceError / SyntaxError / RangeError / EvalError / URIError / AggregateError |
| format | string | 期待される形式：absolutePath（ローカルの完全なパス） / fileName / url / json / regex（正規表現） / numericExpression / cookie / a1Range（スプレッドシートの範囲） / spreadsheetId / serviceAccountKey / hostname / selector / dateTime / fieldPath / identifier |
| allowed | string[] | 許可される値またはファイル拡張子（ユーザーデータではなく常に設定値。`["append","overwrite"]` や `[".txt"]` など） |
| reference | string | 解決できなかったテンプレートの参照（`node_3.data.title` や `parameters.keyword` など） |
| cause | string | `ATOM_FAILED` / `CONTROL_FAILED`（フォールバックエラー）、`CDP_ERROR`、`SCRIPT_FAILED` のみ：元の例外メッセージを 1 行にまとめた要約です（改行を除去し、最大 300 文字。内容を置き換えずにそのまま表示）。分類されていない失敗の特定に役立つほか、ブラウザがコマンドを拒否した理由（`Cannot navigate to invalid URL` など）を示します。`SCRIPT_FAILED` の場合は、スクリプト自体の例外メッセージ（`kw is not defined` など）です。 |
| causeName | string | `ATOM_FAILED` / `CONTROL_FAILED` / `CDP_ERROR` のみ：元の例外の型名（1～64 文字の ASCII 英字。`Error` や `ProtocolError` など） |
| upstreamCode | number | string | `RPA_HOST_REQUEST_FAILED` のみ：クライアントがクラウドに環境データを要求したときに、サーバーが返したエラーコードです。この場合、`message` は「RPA run failed: {server message}」になります。サーバーのメッセージは失敗時点のクライアントの UI 言語で、リクエストの言語とは異なる場合があります。ネットワークの障害やタイムアウトの後など、サーバーのエラーコードがない場合、このフィールドは含まれません。その場合、`message` は「RPA run failed: Network error. Check your network connection and try again」になります。 |


以前のバージョンで生成された記録では、`details` が `null` に設定されています。これらの記録の `message` は、もともとエラーコードそのものでした。これらの記録を読み取ると、代わりにこれらの表の説明が返されます。

## 入力と設定

| code | 説明 |
|  --- | --- |
| INVALID_INPUT | ノードの入力が無効です。details.field はフィールドを、details.reason は理由（required、type、range、enum、format のいずれか）を示します。 |
| INVALID_SELECTOR | セレクターの構文が無効です。CSS / XPath / テキストのセレクターを確認してください。 |
| INVALID_REGEX | 正規表現が無効であるか、長さの上限を超えています。 |
| INVALID_REFERENCE | 要素/フレームの参照が無効です。この実行で前のノードが出力した ElementRef または FrameRef を参照する必要があります。 |
| MISSING_VARIABLE | 参照された変数またはノードの出力が存在しません。details.reference は解決できなかった参照、details.field はその参照を含む入力フィールドです。 |
| VARIABLE_TYPE_MISMATCH | 値の型が要件を満たしていません。 |
| LIMIT_EXCEEDED | ノードで許可されている最大数を超えました。 |
| RPA_INVALID_NODE | ノードの設定が無効です。issues の path がフィールドの位置を示します。 |


## 要素

| code | 説明 |
|  --- | --- |
| OPTION_NOT_FOUND | ドロップダウンに、選択できる対象のオプションがありません（オプションが存在しない、無効になっている、または単一選択/複数選択と一致しない）。 |
| ELEMENT_NOT_FOUND | 待機時間内に一致する要素が見つかりませんでした。セレクター、インデックス、ページの読み込みが完了しているかどうかを確認してください。 |
| ELEMENT_NOT_VISIBLE | 要素は存在しますが、表示されていないか、クリックできません（非表示になっている、サイズが 0 である、または覆われている）。 |
| ELEMENT_NOT_FOCUSABLE | 要素がフォーカスを受け取れません。 |
| ELEMENT_NOT_EDITABLE | 要素を編集できません（読み取り専用である、無効になっている、または入力コントロールではない）。 |
| ELEMENT_TYPE_MISMATCH | 要素の種類がノードの要件を満たしていません。たとえば、ドロップダウン選択ノードの対象が select 要素ではない場合です。 |
| FRAME_NOT_FOUND | 対象の要素が iframe ではないか、iframe の内容にアクセスできません。 |
| STALE_REFERENCE | 要素の参照が無効になりました（ページが遷移したか、要素が削除された）。要素を再度取得してください。 |


## ページとタブ

| code | 説明 |
|  --- | --- |
| TAB_NOT_FOUND | 条件に一致するタブがありません。 |
| NO_ACTIVE_PAGE | 操作対象のタブがありません。 |
| PAGE_CLOSED | 操作中にページまたはブラウザが閉じられました。 |
| PAGE_NAVIGATED | 操作中にページが遷移したか、フレームが削除されました。ページが安定してから再試行してください。 |
| CDP_ERROR | ブラウザが自動化コマンドを拒否しました。details.cause は、ブラウザが返したエラーの要約です（Cannot navigate to invalid URL など）。 |
| CDP_NOT_READY | ブラウザのデバッグ接続がまだ準備できていません。 |


## ナビゲーション

| code | 説明 |
|  --- | --- |
| NAVIGATION_FAILED | ブラウザが URL を開けません。details.netError は Chromium のネットワークエラーです（ERR_NAME_NOT_RESOLVED や ERR_CONNECTION_REFUSED など）。 |


## ネットワークと外部リクエスト

| code | 説明 |
|  --- | --- |
| HTTP_ERROR | HTTP リクエストが成功以外のステータスを返しました。details.httpStatus はそのステータスコードです。 |
| NETWORK_REQUEST_FAILED | ネットワークリクエストが失敗しました（接続拒否、タイムアウト、DNS エラー、または証明書エラー）。details.systemCode で理由が示されます。 |
| NETWORK_DOWNLOAD_FAILED | 添付ファイルのアップロード前に、リモートのファイルをダウンロードできませんでした。details の httpStatus / netError / systemCode で理由が示されます。 |
| NETWORK_WAIT_TIMEOUT | 待機時間内に、一致するネットワークリクエストまたはレスポンスを取得できませんでした。details.matchedCount は、取得されたもののまだレスポンスがないリクエストの数です（0 は、一致するリクエストがなかったことを意味します）。 |
| LISTENER_NOT_FOUND | ネットワーク監視が実行されていないか、監視 ID が存在しません。先に「ネットワーク監視を開始」を実行してください。 |
| RESPONSE_BODY_UNAVAILABLE | レスポンス本文を読み取れません（リダイレクトである、インターセプトされた、解放済みである、またはバイナリである）。 |
| RESPONSE_LIMIT | レスポンスの内容がサイズの上限を超えています。 |
| PROVIDER_CONNECTION_ERROR | 外部サービスに接続できません。 |
| PROVIDER_HTTP_ERROR | 外部サービスがエラーステータスを返しました。 |
| INVALID_PROVIDER_RESPONSE | 外部サービスが無効な形式のデータを返しました。 |


## スクリプトと出力

| code | 説明 |
|  --- | --- |
| OUTPUT_TYPE_MISMATCH | 戻り値が、設定された出力形式と一致しません。details.expected は期待される型です。 |
| SCRIPT_FAILED | ユーザースクリプトが実行中に例外をスローしました。details.errorName は例外の型（TypeError や ReferenceError など）、details.cause は例外メッセージの要約（kw is not defined など）です。 |


## ファイル

| code | 説明 |
|  --- | --- |
| ENOENT | ファイルまたはディレクトリが存在しません。 |
| EACCES | ファイルまたはディレクトリへのアクセス権限がありません。 |
| EPERM | システムがこのファイル操作を許可していません。 |
| EROFS | 対象の場所は、読み取り専用のファイルシステム上にあります。 |
| EEXIST | 対象のファイルはすでに存在します。 |
| ENOTDIR | パスの構成要素がディレクトリではありません。 |
| EISDIR | 対象はファイルではなく、ディレクトリです。 |
| ENOSPC | ディスクの空き容量が不足しています。 |
| EBUSY | ファイルが使用中です。 |
| ENAMETOOLONG | ファイルパスが長すぎます。 |
| EMFILE | 開いているファイルが多すぎます。 |
| ENOTEMPTY | ディレクトリが空ではありません。 |
| EXDEV | ディスクをまたいでファイルを移動することはできません。 |
| FILE_IN_USE | 対象のファイルは、ほかのプログラムで使用中です（Excel で開いている場合など）。ファイルを閉じてから再試行してください。元のファイルは変更されていません。 |
| FILE_NOT_WRITABLE | 対象のファイルはすでに存在し、書き込みできない（読み取り専用属性または権限の制限）ため、上書きも書き込みもできません。ファイル名を変更するか、ファイルの読み取り専用属性を解除してください。 |
| FILE_LIMIT | ファイルのサイズまたはファイルの数が上限を超えています。 |
| UPLOAD_FAILED | ブラウザが、選択されたファイルを受け付けませんでした。 |
| ARTIFACT_WRITE_FAILED | 実行の終了時に、成果物のファイルを書き込めませんでした。 |


## データ処理

| code | 説明 |
|  --- | --- |
| MISSING_FIELD | 指定された JSON のフィールドパスが存在しません。 |
| OUTPUT_TOO_LARGE | ノードの出力が、記録できる最大サイズ（50 MB）を超えています。details.limit は、バイト単位の上限です。 |
| SHEET_NO_DATA | ワークシートにデータがありません。 |
| SHEET_NOT_FOUND | ブックに、指定された名前のワークシートがありません。details.field は、ワークシート名のフィールドです。 |
| SHEET_HEADER_INVALID | シートの 1 行目（ヘッダー）には、重複がなく空でない列名が必要です。また、データ行の列数がヘッダーの列数を超えることはできません。 |
| VALUE_CONVERSION_FAILED | データ内の値を、要求どおりに変換または比較できません。details.field は対応するフィールド、details.expected は期待される型です。 |
| INVALID_JSON_RESPONSE | 返された内容が有効な JSON ではありません。 |


## メール

| code | 説明 |
|  --- | --- |
| MAIL_CONNECTION_FAILED | メールサーバーへの接続またはログインに失敗しました。ホスト、ポート、TLS、認証情報を確認してください。 |
| MAIL_TLS_MISMATCH | 接続後にメールサーバーが IMAP のグリーティングを返さなかったか、TLS ハンドシェイクが拒否されました。通常は、ポートと TLS の設定が一致していないことを意味します（たとえば、ポート 993 では TLS が必要です）。 |
| MAIL_PROVIDER_UNSUPPORTED | このメールサービスは、選択された認証方式またはフォルダーをサポートしていません（OAuth2 と迷惑メールフォルダーは Outlook でのみサポートされます）。 |
| MAIL_JUNK_FOLDER_UNAVAILABLE | メールボックスに、アクセスできる迷惑メールフォルダーがありません。 |
| MAIL_MESSAGE_LIMIT | メールの内容が読み取りの上限を超えています。 |
| MAIL_SEARCH_LIMIT | 一致するメールの数が読み取りの上限を超えています。絞り込み条件を追加してください。 |
| MAIL_SEARCH_FAILED | メールサーバーが検索条件を拒否しました（NO/BAD）。絞り込み条件を調整してください。 |
| MAIL_CREDENTIAL_STORE_ERROR | メールボックスの認可情報を読み取りまたは保存できませんでした。 |


## ブラウザ環境とクライアント

| code | 説明 |
|  --- | --- |
| NO_BROWSER | 接続されているブラウザ環境がありません。 |
| NO_ACTIVE_ENVIRONMENT | アクティブなブラウザ環境がありません（閉じられた可能性があります）。先に環境を起動するか、環境に切り替えてください。 |
| UNKNOWN_ENVIRONMENT | 環境が存在しないか、この実行で開いた環境ではありません。 |
| INVALID_ENVIRONMENT | 環境の情報が無効であるか、環境が Chromium 環境ではありません。 |
| ENVIRONMENT_CLOSED | 環境は閉じられています。 |
| ENVIRONMENT_STILL_RUNNING | 閉じる操作の後も環境が実行中のため、閉じたことを確認できませんでした。 |
| RPA_BROWSER_CORE_MISSING | このコンピューターには、環境に必要なブラウザカーネルがありません。クライアントが自動的にダウンロードを開始します（進行状況は「アップデートセンター」で確認できます）。ダウンロードが完了してから、再度実行してください。 |
| RPA_BROWSER_CORE_UPDATE_REQUIRED | 環境には、ブラウザカーネルの更新が必要です。クライアントが新しいカーネルのダウンロードを自動的に開始します（進行状況は「アップデートセンター」で確認できます）。ダウンロードが完了してから、再度実行してください。 |
| RPA_BROWSER_CORE_SYSTEM_UNSUPPORTED | 現在のオペレーティングシステムは、このブラウザカーネルをサポートしていません。 |
| RPA_BROWSER_CORE_OFFLINE | このブラウザカーネルは提供が終了しています。別のカーネルバージョンに切り替えてください。 |
| RPA_BROWSER_CACHE_PATH_INVALID | ブラウザのキャッシュディレクトリが無効です。 |
| RPA_CLIENT_UPDATE_REQUIRED | クライアントのバージョンが古すぎます。クライアントを更新してから再試行してください。 |
| RPA_BROWSER_NOT_READY | ブラウザは起動しましたが、デバッグ接続の準備ができていません。 |
| RPA_BROWSER_START_FAILED | ブラウザ環境を起動できませんでした（組み込みの拡張機能による環境チェックが失敗した場合を含みます）。環境一覧から手動で環境を開いて、トラブルシューティングしてください。 |
| RPA_BROWSER_CONNECT_FAILED | ブラウザ環境は開いていますが、自動化の接続を確立できません。環境を閉じてから再試行してください。 |
| RPA_BROWSER_CLOSE_TIMEOUT | ブラウザが閉じるのを待機している間にタイムアウトしました。 |
| RPA_HEADLESS_CORE_UNSUPPORTED | ヘッドレスブラウザでサポートされるのは、ブラウザカーネルのバージョン 130 以降のみです。 |
| RPA_ENVIRONMENT_NOT_FOUND | 指定された環境が見つかりません（ID またはシリアル番号が存在しません）。 |
| RPA_ENVIRONMENT_AMBIGUOUS | 指定された条件に一致する環境が複数あります。環境 ID を使用してください。 |
| RPA_ENVIRONMENT_ID_REQUIRED | 環境 ID が指定されていません。 |
| RPA_ENVIRONMENT_ID_MISMATCH | クライアントが返した環境が、リクエストと一致しません。 |
| RPA_UNSAFE_ENVIRONMENT_ID | 環境 ID が安全な整数の範囲を超えています。文字列として渡してください。 |
| RPA_ENVIRONMENT_OUTSIDE_TASK | この環境は、この実行で許可されている範囲外です。 |
| RPA_ENVIRONMENT_STATUS_UNAVAILABLE | 環境のステータスを読み取れません。 |
| RPA_CHROMIUM_ENVIRONMENT_REQUIRED | サポートされるのは Chromium のブラウザ環境だけです。 |
| RPA_E2E_ENVIRONMENT_UNSUPPORTED | エンドツーエンド暗号化された環境では、ブラウザ RPA はサポートされていません。 |
| RPA_ENVIRONMENT_LOCKED | 環境はほかのメンバーが使用中（セキュリティロック）のため、現在は開けません。 |
| RPA_ENVIRONMENT_TRANSFERRING | 環境は転送中のため、現在は開けません。 |
| RPA_ENVIRONMENT_PROXY_DELETED | 環境に紐付けられたプロキシが削除されているため、環境を起動できません。環境のプロキシ情報を更新してから再試行してください。 |
| RPA_ENVIRONMENT_QUOTA_EXCEEDED | ご利用のプランで利用できる環境数が不足しているため、この環境を開けません。 |
| RPA_ENVIRONMENT_DAILY_OPEN_LIMIT | 環境を開く回数の 1 日あたりの上限に達しました。 |
| RPA_TAG_ID_UNKNOWN_OR_AMBIGUOUS | タグ ID が存在しないか、一意ではありません。使用できるのは、チーム内の既存のタグだけです。 |
| RPA_TAG_CATALOG_INVALID | チームのタグ一覧を読み取れませんでした。 |
| RPA_TAG_READBACK_INVALID | タグは送信されましたが、読み戻しの結果が無効です。 |
| RPA_TAG_UPDATE_NOT_CONFIRMED | タグの更新を読み戻しで確認できませんでした。 |
| RPA_REMARK_READBACK_INVALID | メモは送信されましたが、読み戻しの結果が無効です。 |


## ワークフローの制御

| code | 説明 |
|  --- | --- |
| CONTROL_RUNTIME_REQUIRED | 制御ノードは、ワークフロー内でのみ実行できます。 |
| CONTROL_FAILED | 制御ノードが失敗しました。 |
| BREAK_OUTSIDE_LOOP | 「ループを終了」がループの中にありません。 |
| ITERATION_LIMIT | ループの反復回数が上限を超えています。 |
| STEP_LIMIT | ワークフローの実行ステップ数が上限を超えています。 |
| CALL_DEPTH_LIMIT | 子ワークフローのネストの深さが上限を超えています。 |
| WORKFLOW_RECURSION | 子ワークフローは、自分自身を再帰的に呼び出すことはできません。 |
| WORKFLOW_NOT_FOUND | 参照されている子ワークフローのバージョンが見つかりません。 |
| WORKFLOW_REPOSITORY_REQUIRED | 子ワークフローの依存関係が指定されていません。 |
| WORKFLOW_FAILED | 子ワークフローが失敗しました。 |
| NODE_FAILED | ノードが失敗しました。 |
| END_FAILED | ワークフローが失敗状態で終了しました。 |
| NODE_REMOVED | このノードは廃止されています。ワークフローから削除してください。 |
| UNKNOWN_NODE | ノードタイプが不明です。 |
| UNSUPPORTED_NODE | 現在のバージョンは、このノードをサポートしていません。 |
| RPA_TASK_TIMEOUT | タスクがタイムアウトし、実行が停止されました。 |
| RPA_ACTION_UNSUPPORTED | 現在のバージョンは、このノードをサポートしていません（廃止されているか、利用できません）。 |


## ランタイム

| code | 説明 |
|  --- | --- |
| INVALID_SEED | デバッグ用にキャッシュされたノードの結果が無効です。前のノードを再度実行してください。 |
| TASK_METADATA_REQUIRED | タスクの情報がないため、成果物の既定のパスを生成できません。 |
| TIMEOUT | ノードがタイムアウトしました。タイムアウトは失敗として扱われ、設定された再試行、失敗時のスクリーンショット、例外処理が適用されます。details.limit はミリ秒単位のタイムアウト、details.phase はノードが処理していた段階です。 |
| CANCELLED | キャンセル要求により実行が停止しました。 |
| OUTCOME_UNKNOWN | 実行が停止したかどうかを確認できませんでした。実行は failed として表示され、停止が確認されるまで実行環境は分離されたままになります。外部への影響が確認されていないため、自動的に再実行しないでください。 |
| RPA_INTERRUPTED | クライアントが終了したか、エラーが発生したため、実行が中断され、failed として表示されています。再度実行する前に、ページ上の実際の結果を確認してください。 |
| ATOM_FAILED | ブラウザのアクションが失敗し、具体的な原因を特定できません。失敗したノードの入力、スクリーンショット、ページの状態を使ってトラブルシューティングしてください。 |
| ATOM_IN_FLIGHT | 同じ実行コンテキストで、すでにアクションが実行中です。 |
| CONTEXT_ACTIVE | 実行コンテキストがまだ使用中です。 |
| CONTEXT_CLOSED | 実行コンテキストは閉じられています。 |
| CONTEXT_QUARANTINED | 前のアクションが安全に終了しませんでした。実行コンテキストは分離され、残りのノードは実行されません。 |
| EXECUTION_FENCED | 実行は停止されており、新しいアクションはもう受け付けません。 |
| WORKER_EXITED | スクリプトの実行プロセスが予期せず終了しました。 |
| RPA_EXECUTION_FAILED | ワークフローが失敗しました。失敗したノードの実行記録を確認してください。 |


## クライアントホスト

| code | 説明 |
|  --- | --- |
| GOOGLE_SHEETS_CONFIG_REQUIRED | Google スプレッドシートのサービスが設定されていません。 |
| HOST_ADAPTER_REQUIRED | このノードにはクライアント環境の機能が必要ですが、現在の実行コンテキストでは利用できません。 |
| RPA_INVALID_HOST_RESPONSE | クライアントが無効なデータを返しました。 |
| RPA_PERMISSION_DENIED | 現在のアカウントには、この環境を操作する権限がありません。 |
| RPA_HOST_FAILED | クライアントがリクエストを処理できませんでした。 |
| RPA_HOST_REQUEST_FAILED | クライアントからクラウドへの、環境またはアカウントのデータの要求が失敗しました。サーバーが要求を拒否した場合、details.upstreamCode はサーバーのエラーコードで、message にはサーバーのメッセージが含まれます。それ以外の場合は、ネットワークの障害です。ネットワークとログイン状態を確認してから再試行してください。 |
| RPA_HOST_TIMEOUT | クライアントでの処理がタイムアウトし、結果は確認されていません。 |
| RPA_HOST_LOST | クライアントのページとの接続が失われ、結果は確認されていません。 |
| RPA_HOST_UNAVAILABLE | クライアントのメインウィンドウを利用できません。 |
| RPA_HOST_INVALID_RESPONSE | クライアントが無効なデータを返しました。 |
| RPA_SESSION_EXPIRED | クライアントのセッションの有効期限が切れています。ページを開き直してください。 |


## Local API リクエスト

以下のエラーコードは、Local API リクエスト自体が返すものです（`error.code`、`issues[].code`、`warnings[].code` に含まれます）。ノード実行記録や実行記録には現れません。HTTP ステータスとリカバリーの手順については、[API の規約](/ja/browser-rpa/api/common)と[エラー詳細とリカバリーマトリクス](/ja/browser-rpa/api/recovery)を参照してください。

| code | 説明 |
|  --- | --- |
| RPA_LOGIN_REQUIRED | 先に MoreLogin クライアントにログインしてください。 |
| RPA_NOT_FOUND | リソースが存在しないか、現在のアカウント/チームのデータスコープにありません。 |
| RPA_INVALID_REQUEST | リクエストの形式が API の契約と一致しません。パス、パラメーター、ヘッダー、本文を確認してください。 |
| RPA_INVALID_TEXT | テキストが空であるか、長さの制限を満たしていません。 |
| RPA_PRECONDITION_REQUIRED | If-Match には、テンプレートを読み取ったときに返された強い ETag を設定してください。 |
| RPA_VERSION_CONFLICT | テンプレートが変更されています。読み直してから、編集の候補を検証してください。 |
| RPA_TEMPLATE_VERSION_CONFLICT | リクエスト内のテンプレートのバージョンが古くなっています。現在のバージョンを読み取ってください。 |
| RPA_CATALOG_CHANGED | ノードカタログのリビジョンがないか、古くなっています。capabilities とノード契約を再取得してください。 |
| RPA_VALIDATION_FAILED | ワークフローの検証に失敗しました。issues に示された位置の問題を修正してから、再度検証してください。 |
| RPA_NODE_INPUT_INVALID | ノードの入力が、ノードの契約または値の制約と一致しません。 |
| RPA_REFERENCE_NOT_FOUND | 参照されたパラメーター、ノード、または出力フィールドが存在しません。 |
| RPA_REFERENCE_ORDER_INVALID | 参照されたノードは、現在の位置ではまだ実行されていません。 |
| RPA_PRIVATE_DEFAULT_INVALID | 非公開パラメーターは string 型である必要があります。publicState=retained で維持できるのは、同じテンプレート内の同じ名前の非公開フィールドの既存の既定値だけです。 |
| RPA_PRIVATE_DEFAULT_UNAVAILABLE | 非公開パラメーターの既定値をローカルのセキュアストレージから読み取れなくなったため、今回は未設定として返されます。既定値が必要な場合は、平文を再度送信してください。 |
| RPA_NODE_TITLE_GENERIC | ノードまたは分岐の名前（data.title）がない、空である、またはエディターの既定の名前（アクション名、「分岐」、「既定の分岐」）のままであるため、このステップが何をするのかがエディターに表示されません。「検索結果が表示されるまで待機」や「対象の動画を検索」のように、目的がわかる名前を付けてください。これは注意喚起にすぎず、保存や実行には影響しません。 |
| RPA_UNKNOWN_PARAMETER | リクエストに、テンプレートで宣言されていないパラメーターが含まれています。 |
| RPA_REQUIRED_PARAMETER | テンプレートで宣言された必須パラメーターが指定されていません。 |
| RPA_REQUEST_CONFLICT | 同じ冪等性キーが、すでに別のリクエストの意図に使用されています。 |
| RPA_REQUEST_NOT_COMMITTED | この冪等性キーでは何もコミットされていないことが確認されています。元の意図が変わっていない場合は、元のキーで再試行できます。 |
| RPA_REQUEST_EXPIRED | この冪等性キーのリカバリー期間が終了しています。まずリソースの状態を確認してください。 |
| RPA_DEPENDENCY_UNAVAILABLE | 参照されている子テンプレートが削除されているか、利用できません。参照を更新してから、再度実行してください。 |
| RPA_ENVIRONMENT_BUSY | 環境が実行中か、分離されています。解除されるまで待ってから、再度事前検証を実行してください。 |
| RPA_RATE_LIMITED | リクエストの頻度が高すぎます。Retry-After に従って待機してから、再試行してください。 |
| RPA_VALIDATION_TIMEOUT | 読み取り専用の検証がタイムアウトしました。書き込みはコミットされていません。 |
| RPA_SERVICE_BUSY | サービスが一時的にビジー状態です。再試行するかどうかを判断する前に、元のリクエスト受領記録を照会してください。 |
| RPA_OUTCOME_UNKNOWN | クラウドテンプレートへの書き込みについて確認を受け取れなかったため、結果は不明です。同じ冪等性キーで再試行しても、再度書き込まれることはありません。まずテンプレート一覧を確認してください。 |
| RPA_INTERNAL | サービスがリクエストを処理できませんでした。トラブルシューティングのために requestId を保存し、書き込みの受領記録を確認してください。 |
| RPA_WORKFLOW_SCHEMA_INVALID | ワークフローの構造が、ワークフローの契約と一致しません。path で位置が、reason で原因（required、type、enum、range、format、または不明なフィールド）が示されます。 |
| RPA_STRUCTURE_INVALID | ワークフローは、ちょうど 1 つの start ノードで始まり、ちょうど 1 つの end ノードで終わる必要があります。 |
| RPA_DUPLICATE_NODE | ノード ID が複数回使用されています。ノードごとに一意の ID を使用してください。 |
| RPA_NODE_LIMIT | ワークフロー内のノード数が上限を超えています。ワークフローを子ワークフローに分割してください。 |
| RPA_DEPTH_LIMIT | ワークフローのネストの深さが上限を超えています。グループや分岐のネストを減らしてください。 |
| RPA_LIMIT_EXCEEDED | リクエストの内容が、サイズまたは数の上限を超えています。details の limit / maxBytes で上限が示されます。 |
| RPA_REFERENCE_NOT_VISIBLE | 参照されたノードは、現在の位置からは可視ではありません（別の分岐にあるか、このノードより後にあります）。代わりに、この位置より前に必ず実行されるノードを参照してください。 |
| RPA_REFERENCE_FIELD_NOT_FOUND | 参照されたノードの出力に、このフィールドがありません。ノード契約の outputVariants に基づいて、フィールド名を修正してください。 |
| RPA_REFERENCE_EXPRESSION_UNSUPPORTED | ${…} に含められるのは変数の参照パスだけで、算術演算やその他の式は含められません。数値の計算は、数値式（numericExpression）をサポートする数値フィールドに "${loop.data.index}+1" のように記述してください。 |
| RPA_INVALID_REFERENCE | 参照の構文が無効です。ref に含められるのは type と content だけで、content は空でない文字列の配列である必要があります。constant に含められるのも type と content だけです。 |
| RPA_RUNTIME_CHECK_REQUIRED | 参照されたノードは実行されない可能性があります（条件分岐またはループの中にあります）。実行時に値が生成されない場合、実行は失敗します。 |
| RPA_AUTHORING_RESTRICTED | このノードまたはフィールドには、クライアントの UI でのみ編集できる機密性の高い設定が含まれています。Local API では書き込めません。 |
| RPA_EXTERNAL_EXECUTION_RESTRICTED | ワークフローに、クライアントの UI からのみ実行できるノードが含まれているため、Local API では実行できません。 |
| RPA_DEFAULT_CONFLICT | 同じパラメーターで default と extra.defaultValue の両方が設定されており、2 つの値が異なります。どちらか一方だけを残してください。 |
| RPA_PRIVATE_DEFAULT_CLEARED | 今回の書き込みでは非公開パラメーターの既定値（平文または publicState=retained）が送信されなかったため、既存の既定値はクリアされます。維持するには、平文または retained を送信してください。 |
| RPA_REDACTED_CONTENT_READ_ONLY | テンプレートに、マスクされた古い機密性の高いリテラルが含まれています。先にクライアントで移行してください。移行した後でなければ、Local API でテンプレートを編集またはコピーすることはできません。 |
| RPA_INVALID_NODE_EDIT | ノード編集の操作が無効です。issues の path が、失敗した操作とフィールドを示します。 |
| RPA_UNSUPPORTED_MEDIA_TYPE | リクエスト本文は application/json である必要があります。 |
| RPA_DEPENDENCY_VERSION_UNAVAILABLE | 参照されている子テンプレートのバージョンを利用できません。最新のテンプレートを読み取ってから、再度検証してください。 |
| RPA_ENVIRONMENT_UNAVAILABLE | 指定されたブラウザ環境を解決できません。既存の環境の一覧とクライアントの状態を確認してください。 |
| RPA_SERVICE_UNAVAILABLE | ブラウザ RPA サービスを一時的に利用できません（クライアントがログインしていない、起動中である、または閉じられている）。クライアントにログインしていることを確認してから、再試行してください。 |
| RPA_REQUEST_TIMEOUT | クライアントでのリクエストの処理がタイムアウトし、結果は確認されていません。書き込みの場合は、再試行するかどうかを判断する前に、元の冪等性キーで受領記録を照会してください。 |