# Error codes

> This page lists the error codes that can appear in Browser RPA node records (`error` in `nodes.list` / `GET /runs/{id}/nodes`), run results (`run.error`), and Local API requests.
When you read `docs/api/error-codes.md` through the Local API, the version in the request language is returned. The rules are the same as for `message`: `Accept-Language` takes precedence, the client UI language applies when the header is absent, and unsupported languages return en-US. To read a fixed language, use `error-codes.<language>.md`. The Chinese version is `error-codes.zh-CN.md`.


## Error object

```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`: A stable error code. Base recovery and branching logic on it.
- `message`: A human-readable message. It is the same sentence that the client UI shows for the same error. It is returned in the language of the `Accept-Language` request header, or in the client UI language when the header is absent. The text changes across versions and languages, so programs should decide based on `code` and `details` and should not parse `message`. The "Description" column in the tables below is a developer-facing description of each error code. It is not the `message` that the API returns.
- `details`: Optional structured context, or `null` when no information is available. Only the fields in the table below can appear. Apart from `cause`, it never contains raw exception text, URLs, selectors, local paths, page content, or private input. `cause` appears only on `ATOM_FAILED` / `CONTROL_FAILED` (fallback errors used when the specific cause cannot be identified), `CDP_ERROR` (the browser rejected a command), and `SCRIPT_FAILED` (the script threw an exception). It holds the original cause text (a single line of at most 300 characters) with no content substitution.


| Field | Type | Meaning |
|  --- | --- | --- |
| field | string | The node input field that caused the error, such as `selector`, `exception.retryTimes`, or `fields[0].key` |
| reason | string | `required` (required value missing), `type` (wrong type), `range` (out of range), `enum` (not an allowed value), `format` (invalid format), `conflict` (conflicting fields), `limit` (limit exceeded), `timeout` (timed out), `cancelled` (was cancelled), `unknown` (unknown field or value), `duplicate` (duplicated), `empty` (empty list or content) |
| expected | string | Expected type: string / number / integer / boolean / object / array / null |
| min / max / limit | number | Lower bound of a range, upper bound of a range, or a count/byte/millisecond limit |
| httpStatus | number | HTTP status code |
| netError | string | Chromium network error, such as `ERR_NAME_NOT_RESOLVED`, `ERR_CONNECTION_REFUSED`, or `ERR_BLOCKED_BY_CLIENT` |
| systemCode | string | System error code, such as `ENOENT`, `EROFS`, or `ECONNREFUSED` |
| matchedCount | number | Number of elements actually matched |
| phase | string | Stage at which the failure occurred: navigation / selector / script / download / upload / network / file / host / mail / output |
| errorName | string | Standard exception type thrown by the user script: Error / TypeError / ReferenceError / SyntaxError / RangeError / EvalError / URIError / AggregateError |
| format | string | Expected format: absolutePath (full local path) / fileName / url / json / regex (regular expression) / numericExpression / cookie / a1Range (spreadsheet range) / spreadsheetId / serviceAccountKey / hostname / selector / dateTime / fieldPath / identifier |
| allowed | string[] | Allowed values or file extensions (configuration values, never user data), such as `["append","overwrite"]` or `[".txt"]` |
| reference | string | The template reference that could not be resolved, such as `node_3.data.title` or `parameters.keyword` |
| cause | string | Only on `ATOM_FAILED` / `CONTROL_FAILED` (fallback errors), `CDP_ERROR`, and `SCRIPT_FAILED`: a single-line summary of the original exception message (line breaks removed, at most 300 characters, shown verbatim with no content substitution). It helps locate unclassified failures or explains why the browser rejected a command (such as `Cannot navigate to invalid URL`). For `SCRIPT_FAILED`, it is the script's own exception message (such as `kw is not defined`). |
| causeName | string | Only on `ATOM_FAILED` / `CONTROL_FAILED` / `CDP_ERROR`: the original exception type name (1–64 ASCII letters), such as `Error` or `ProtocolError` |
| upstreamCode | number | string | Only on `RPA_HOST_REQUEST_FAILED`: the error code that the server returned when the client requested environment data from the cloud. In this case, `message` is "RPA run failed: {server message}". The server message is in the client UI language at the time of the failure, which can differ from the request language. The field is absent when there is no server error code, for example after a network failure or timeout. In that case, `message` is "RPA run failed: Network error. Check your network connection and try again". |


Records produced by older versions have `details` set to `null`. Their `message` was originally the error code itself. When these records are read, the description from these tables is returned instead.

## Input and configuration

| code | Description |
|  --- | --- |
| INVALID_INPUT | The node input is invalid. details.field identifies the field, and details.reason gives the reason (required, type, range, enum, or format). |
| INVALID_SELECTOR | The selector syntax is invalid. Check the CSS / XPath / text selector. |
| INVALID_REGEX | The regular expression is invalid or exceeds the length limit. |
| INVALID_REFERENCE | The element/frame reference is invalid. It must reference an ElementRef or FrameRef output by an earlier node in this run. |
| MISSING_VARIABLE | The referenced variable or node output does not exist. details.reference is the reference that could not be resolved, and details.field is the input field that contains it. |
| VARIABLE_TYPE_MISMATCH | The value type does not meet the requirements. |
| LIMIT_EXCEEDED | The maximum count allowed by the node was exceeded. |
| RPA_INVALID_NODE | The node configuration is invalid. The path in issues points to the field location. |


## Elements

| code | Description |
|  --- | --- |
| OPTION_NOT_FOUND | The dropdown has no selectable target option (the option does not exist, is disabled, or does not match single or multiple selection). |
| ELEMENT_NOT_FOUND | No matching element was found within the wait time. Check the selector, the index, and whether the page has loaded. |
| ELEMENT_NOT_VISIBLE | The element exists but is not visible or clickable (it is hidden, has a size of 0, or is covered). |
| ELEMENT_NOT_FOCUSABLE | The element cannot receive focus. |
| ELEMENT_NOT_EDITABLE | The element is not editable (it is read-only, disabled, or not an input control). |
| ELEMENT_TYPE_MISMATCH | The element type does not meet the node requirements. For example, the target of a dropdown selection node is not a select element. |
| FRAME_NOT_FOUND | The target element is not an iframe, or the iframe content is not accessible. |
| STALE_REFERENCE | The element reference is no longer valid (the page navigated or the element was removed). Get the element again. |


## Pages and tabs

| code | Description |
|  --- | --- |
| TAB_NOT_FOUND | No tab matches the conditions. |
| NO_ACTIVE_PAGE | There is no tab to operate on. |
| PAGE_CLOSED | The page or browser was closed during the operation. |
| PAGE_NAVIGATED | The page navigated or a frame was removed during the operation. Try again after the page is stable. |
| CDP_ERROR | The browser rejected an automation command. details.cause is the error summary returned by the browser, such as Cannot navigate to invalid URL. |
| CDP_NOT_READY | The browser debugging connection is not ready yet. |


## Navigation

| code | Description |
|  --- | --- |
| NAVIGATION_FAILED | The browser cannot open the URL. details.netError is the Chromium network error (such as ERR_NAME_NOT_RESOLVED or ERR_CONNECTION_REFUSED). |


## Network and external requests

| code | Description |
|  --- | --- |
| HTTP_ERROR | The HTTP request returned a non-success status. details.httpStatus is the status code. |
| NETWORK_REQUEST_FAILED | The network request failed (connection refused, timeout, DNS error, or certificate error). details.systemCode gives the reason. |
| NETWORK_DOWNLOAD_FAILED | The remote file could not be downloaded before the attachment upload. In details, httpStatus / netError / systemCode give the reason. |
| NETWORK_WAIT_TIMEOUT | No matching network request or response was captured within the wait time. details.matchedCount is the number of requests that were captured but still have no response (0 means that no request matched). |
| LISTENER_NOT_FOUND | No network listener is running, or the listener ID does not exist. Run "Start network listener" first. |
| RESPONSE_BODY_UNAVAILABLE | The response body cannot be read (it is a redirect, was intercepted, has been released, or is binary). |
| RESPONSE_LIMIT | The response content exceeds the size limit. |
| PROVIDER_CONNECTION_ERROR | The external service cannot be reached. |
| PROVIDER_HTTP_ERROR | The external service returned an error status. |
| INVALID_PROVIDER_RESPONSE | The external service returned data in an invalid format. |


## Scripts and output

| code | Description |
|  --- | --- |
| OUTPUT_TYPE_MISMATCH | The return value does not match the configured output format. details.expected is the expected type. |
| SCRIPT_FAILED | The user script threw an exception during execution. details.errorName is the exception type (such as TypeError or ReferenceError), and details.cause is a summary of the exception message, such as kw is not defined. |


## Files

| code | Description |
|  --- | --- |
| ENOENT | The file or directory does not exist. |
| EACCES | You do not have permission to access the file or directory. |
| EPERM | The system does not allow this file operation. |
| EROFS | The target location is on a read-only file system. |
| EEXIST | The target file already exists. |
| ENOTDIR | A component of the path is not a directory. |
| EISDIR | The target is a directory, not a file. |
| ENOSPC | There is not enough disk space. |
| EBUSY | The file is in use. |
| ENAMETOOLONG | The file path is too long. |
| EMFILE | Too many files are open. |
| ENOTEMPTY | The directory is not empty. |
| EXDEV | Files cannot be moved across disks. |
| FILE_IN_USE | The target file is in use by another program (for example, it is open in Excel). Close it and try again. The original file was not modified. |
| FILE_NOT_WRITABLE | The target file already exists and is not writable (read-only attribute or permission restrictions), so it cannot be overwritten or written to. Change the name or clear the read-only attribute of the file. |
| FILE_LIMIT | The file size or the number of files exceeds the limit. |
| UPLOAD_FAILED | The browser did not accept the selected file. |
| ARTIFACT_WRITE_FAILED | The artifact file could not be written at the end of the run. |


## Data processing

| code | Description |
|  --- | --- |
| MISSING_FIELD | The specified JSON field path does not exist. |
| OUTPUT_TOO_LARGE | The node output exceeds the maximum size that can be recorded (50 MB). details.limit is the limit in bytes. |
| SHEET_NO_DATA | The worksheet has no data. |
| SHEET_NOT_FOUND | The workbook has no worksheet with the specified name. details.field is the worksheet name field. |
| SHEET_HEADER_INVALID | The first row of the sheet (the header) must contain unique, non-empty column names, and data rows cannot have more columns than the header. |
| VALUE_CONVERSION_FAILED | A value in the data cannot be converted or compared as required. details.field is the corresponding field, and details.expected is the expected type. |
| INVALID_JSON_RESPONSE | The returned content is not valid JSON. |


## Email

| code | Description |
|  --- | --- |
| MAIL_CONNECTION_FAILED | The connection or login to the mail server failed. Check the host, port, TLS, and credentials. |
| MAIL_TLS_MISMATCH | The mail server did not return an IMAP greeting after the connection, or the TLS handshake was rejected. This usually means that the port and the TLS setting do not match (for example, port 993 requires TLS). |
| MAIL_PROVIDER_UNSUPPORTED | This email service does not support the selected authentication method or folder (OAuth2 and the junk folder are supported only for Outlook). |
| MAIL_JUNK_FOLDER_UNAVAILABLE | The mailbox has no accessible junk email folder. |
| MAIL_MESSAGE_LIMIT | The email content exceeds the read limit. |
| MAIL_SEARCH_LIMIT | The number of matching emails exceeds the read limit. Add more filter conditions. |
| MAIL_SEARCH_FAILED | The mail server rejected the search criteria (NO/BAD). Adjust the filter conditions. |
| MAIL_CREDENTIAL_STORE_ERROR | The mailbox authorization information could not be read or saved. |


## Browser environments and the client

| code | Description |
|  --- | --- |
| NO_BROWSER | No browser environment is connected. |
| NO_ACTIVE_ENVIRONMENT | There is no active browser environment (it may have been closed). Start or switch to an environment first. |
| UNKNOWN_ENVIRONMENT | The environment does not exist, or this run did not open it. |
| INVALID_ENVIRONMENT | The environment information is invalid, or the environment is not a Chromium environment. |
| ENVIRONMENT_CLOSED | The environment is closed. |
| ENVIRONMENT_STILL_RUNNING | The environment is still running after it was closed, so the close could not be confirmed. |
| RPA_BROWSER_CORE_MISSING | This computer does not have the browser kernel that the environment requires. The client starts downloading it automatically (you can check the progress in the Update Center). Run again after the download finishes. |
| RPA_BROWSER_CORE_UPDATE_REQUIRED | The environment requires a browser kernel update. The client starts downloading the new kernel automatically (you can check the progress in the Update Center). Run again after the download finishes. |
| RPA_BROWSER_CORE_SYSTEM_UNSUPPORTED | The current operating system does not support this browser kernel. |
| RPA_BROWSER_CORE_OFFLINE | The browser kernel has been discontinued. Switch to a different kernel version. |
| RPA_BROWSER_CACHE_PATH_INVALID | The browser cache directory is invalid. |
| RPA_CLIENT_UPDATE_REQUIRED | The client version is too old. Update the client and try again. |
| RPA_BROWSER_NOT_READY | The browser has started, but the debugging connection is not ready. |
| RPA_BROWSER_START_FAILED | The browser environment failed to start (including when the built-in extension environment check fails). Open the environment manually from the environment list to troubleshoot. |
| RPA_BROWSER_CONNECT_FAILED | The browser environment is open, but an automation connection cannot be established. Close the environment and try again. |
| RPA_BROWSER_CLOSE_TIMEOUT | Waiting for the browser to close timed out. |
| RPA_HEADLESS_CORE_UNSUPPORTED | The headless browser supports only browser kernel version 130 and later. |
| RPA_ENVIRONMENT_NOT_FOUND | The specified environment cannot be found (the ID or serial number does not exist). |
| RPA_ENVIRONMENT_AMBIGUOUS | The specified conditions match more than one environment. Use the environment ID. |
| RPA_ENVIRONMENT_ID_REQUIRED | The environment ID is missing. |
| RPA_ENVIRONMENT_ID_MISMATCH | The environment returned by the client does not match the request. |
| RPA_UNSAFE_ENVIRONMENT_ID | The environment ID exceeds the safe integer range. Pass it as a string. |
| RPA_ENVIRONMENT_OUTSIDE_TASK | This environment is outside the scope allowed for this run. |
| RPA_ENVIRONMENT_STATUS_UNAVAILABLE | The environment status cannot be read. |
| RPA_CHROMIUM_ENVIRONMENT_REQUIRED | Only Chromium browser environments are supported. |
| RPA_E2E_ENVIRONMENT_UNSUPPORTED | End-to-end encrypted environments do not support Browser RPA. |
| RPA_ENVIRONMENT_LOCKED | The environment is in use by another member (security lock) and cannot be opened right now. |
| RPA_ENVIRONMENT_TRANSFERRING | The environment is being transferred and cannot be opened right now. |
| RPA_ENVIRONMENT_PROXY_DELETED | The proxy bound to the environment has been deleted, so the environment cannot start. Update the proxy information in the environment and try again. |
| RPA_ENVIRONMENT_QUOTA_EXCEEDED | Your plan does not have enough available environments, so this environment cannot be opened. |
| RPA_ENVIRONMENT_DAILY_OPEN_LIMIT | The daily limit on opening environments has been reached. |
| RPA_TAG_ID_UNKNOWN_OR_AMBIGUOUS | The tag ID does not exist or is not unique. Only existing tags in the team can be used. |
| RPA_TAG_CATALOG_INVALID | The team tag list could not be read. |
| RPA_TAG_READBACK_INVALID | The tags were submitted, but the readback result is invalid. |
| RPA_TAG_UPDATE_NOT_CONFIRMED | The tag update could not be confirmed by readback. |
| RPA_REMARK_READBACK_INVALID | The remark was submitted, but the readback result is invalid. |


## Workflow control

| code | Description |
|  --- | --- |
| CONTROL_RUNTIME_REQUIRED | Control nodes can run only inside a workflow. |
| CONTROL_FAILED | The control node failed. |
| BREAK_OUTSIDE_LOOP | "Exit loop" is not inside a loop. |
| ITERATION_LIMIT | The number of loop iterations exceeds the limit. |
| STEP_LIMIT | The number of workflow execution steps exceeds the limit. |
| CALL_DEPTH_LIMIT | The nesting depth of child workflows exceeds the limit. |
| WORKFLOW_RECURSION | A child workflow cannot call itself recursively. |
| WORKFLOW_NOT_FOUND | The referenced child workflow version cannot be found. |
| WORKFLOW_REPOSITORY_REQUIRED | The child workflow dependencies were not provided. |
| WORKFLOW_FAILED | The child workflow failed. |
| NODE_FAILED | The node failed. |
| END_FAILED | The workflow ended in a failed state. |
| NODE_REMOVED | This node has been discontinued. Remove it from the workflow. |
| UNKNOWN_NODE | The node type is unknown. |
| UNSUPPORTED_NODE | The current version does not support this node. |
| RPA_TASK_TIMEOUT | The task timed out, and the run was stopped. |
| RPA_ACTION_UNSUPPORTED | The current version does not support this node (it has been discontinued or is not available). |


## Runtime

| code | Description |
|  --- | --- |
| INVALID_SEED | The node result cached for debugging is invalid. Run the earlier nodes again. |
| TASK_METADATA_REQUIRED | Task information is missing, so the default artifact path cannot be generated. |
| TIMEOUT | The node timed out. The timeout is handled as a failure, and the configured retries, failure screenshot, and exception handling apply. details.limit is the timeout in milliseconds, and details.phase is the stage that the node was in. |
| CANCELLED | The run stopped because of a cancellation request. |
| OUTCOME_UNKNOWN | Whether the run stopped could not be confirmed. The run is shown as failed, and the execution environment stays isolated until the stop is confirmed. External effects are unconfirmed, so do not rerun automatically. |
| RPA_INTERRUPTED | The run was interrupted because the client exited or encountered an error, and the run is shown as failed. Check the actual result on the page before you run it again. |
| ATOM_FAILED | A browser action failed, and the specific cause cannot be identified. Use the inputs of the failed node, the screenshot, and the page state to troubleshoot. |
| ATOM_IN_FLIGHT | An action is already running in the same execution context. |
| CONTEXT_ACTIVE | The execution context is still in use. |
| CONTEXT_CLOSED | The execution context is closed. |
| CONTEXT_QUARANTINED | The previous action did not end safely. The execution context is isolated, and the remaining nodes will not run. |
| EXECUTION_FENCED | The run has been stopped and no longer accepts new actions. |
| WORKER_EXITED | The script execution process exited unexpectedly. |
| RPA_EXECUTION_FAILED | The workflow failed. Check the failed node records. |


## Client host

| code | Description |
|  --- | --- |
| GOOGLE_SHEETS_CONFIG_REQUIRED | The Google Sheets service is not configured. |
| HOST_ADAPTER_REQUIRED | This node requires client environment capabilities, which are not available in the current execution context. |
| RPA_INVALID_HOST_RESPONSE | The client returned invalid data. |
| RPA_PERMISSION_DENIED | The current account does not have permission to operate this environment. |
| RPA_HOST_FAILED | The client failed to process the request. |
| RPA_HOST_REQUEST_FAILED | The client request to the cloud for environment or account data failed. If the server rejected it, details.upstreamCode is the server error code, and message includes the server message. Otherwise, it is a network failure. Check the network and the login state, then try again. |
| RPA_HOST_TIMEOUT | The client timed out while processing, and the result is unconfirmed. |
| RPA_HOST_LOST | The connection to the client page was lost, and the result is unconfirmed. |
| RPA_HOST_UNAVAILABLE | The main window of the client is unavailable. |
| RPA_HOST_INVALID_RESPONSE | The client returned invalid data. |
| RPA_SESSION_EXPIRED | The client session has expired. Reopen the page. |


## Local API requests

The following error codes are returned by Local API requests themselves (in `error.code`, `issues[].code`, and `warnings[].code`). They do not appear in node or run records. For HTTP statuses and recovery steps, see [API conventions](/browser-rpa/api/common) and [Error details and recovery matrix](/browser-rpa/api/recovery).

| code | Description |
|  --- | --- |
| RPA_LOGIN_REQUIRED | Log in to the MoreLogin client first. |
| RPA_NOT_FOUND | The resource does not exist or is not in the data scope of the current account/team. |
| RPA_INVALID_REQUEST | The request format does not match the API contract. Check the path, parameters, headers, and body. |
| RPA_INVALID_TEXT | The text is empty or does not meet the length limits. |
| RPA_PRECONDITION_REQUIRED | Set If-Match to the strong ETag returned when you read the template. |
| RPA_VERSION_CONFLICT | The template has been modified. Read it again, then validate the edit candidate. |
| RPA_TEMPLATE_VERSION_CONFLICT | The template version in the request is stale. Read the current version. |
| RPA_CATALOG_CHANGED | The node catalog revision is missing or stale. Refresh capabilities and the node contracts. |
| RPA_VALIDATION_FAILED | Workflow validation failed. Fix the problems at the locations in issues, then validate again. |
| RPA_NODE_INPUT_INVALID | The node input does not match the contract or value constraints of the node. |
| RPA_REFERENCE_NOT_FOUND | The referenced parameter, node, or output field does not exist. |
| RPA_REFERENCE_ORDER_INVALID | The referenced node has not run yet at the current position. |
| RPA_PRIVATE_DEFAULT_INVALID | Private parameters must be of type string. With publicState=retained, you can keep only the existing default value of a private field with the same name in the same template. |
| RPA_PRIVATE_DEFAULT_UNAVAILABLE | The default value of the private parameter can no longer be read from local secure storage, so it is returned as unset this time. If you need a default value, submit the plaintext again. |
| RPA_NODE_TITLE_GENERIC | The name of the node or branch (data.title) is missing, empty, or still the editor's default name (the action name, "Branch", or "Default branch"), so the editor does not show what this step does. Use a name that describes its purpose, such as "Wait for search results to appear" or "Find the target video". This is only a reminder and does not affect saving or running. |
| RPA_UNKNOWN_PARAMETER | The request contains a parameter that the template does not declare. |
| RPA_REQUIRED_PARAMETER | A required parameter declared by the template is missing. |
| RPA_REQUEST_CONFLICT | The same idempotency key has already been used for a different request intent. |
| RPA_REQUEST_NOT_COMMITTED | It is confirmed that nothing was committed for this idempotency key. If the original intent has not changed, you can retry with the original key. |
| RPA_REQUEST_EXPIRED | The recovery window for this idempotency key has expired. Check the resource state first. |
| RPA_DEPENDENCY_UNAVAILABLE | The referenced child template has been deleted or is unavailable. Update the reference, then run again. |
| RPA_ENVIRONMENT_BUSY | The environment is running or isolated. Wait until it is released, then run the preflight again. |
| RPA_RATE_LIMITED | Requests are too frequent. Wait as indicated by Retry-After, then try again. |
| RPA_VALIDATION_TIMEOUT | The read-only validation timed out. No write was committed. |
| RPA_SERVICE_BUSY | The service is temporarily busy. Query the original request receipt before you decide whether to retry. |
| RPA_OUTCOME_UNKNOWN | No confirmation was received for the cloud template write, so the outcome is unknown. A retry with the same idempotency key does not write again. Check the template list first. |
| RPA_INTERNAL | The service failed to process the request. Keep the requestId for troubleshooting, and check the write receipt. |
| RPA_WORKFLOW_SCHEMA_INVALID | The workflow structure does not match the workflow contract. The path gives the location, and the reason gives the cause (required, type, enum, range, format, or unknown field). |
| RPA_STRUCTURE_INVALID | A workflow must start with exactly one start node and end with exactly one end node. |
| RPA_DUPLICATE_NODE | A node ID is used more than once. Use a unique ID for each node. |
| RPA_NODE_LIMIT | The number of nodes in the workflow exceeds the limit. Split the workflow into child workflows. |
| RPA_DEPTH_LIMIT | The workflow nesting depth exceeds the limit. Reduce the nesting of groups or branches. |
| RPA_LIMIT_EXCEEDED | The request content exceeds a size or count limit. In details, limit / maxBytes gives the limit. |
| RPA_REFERENCE_NOT_VISIBLE | The referenced node is not visible at the current position (it is in another branch or after this node). Reference a node that always runs before this point instead. |
| RPA_REFERENCE_FIELD_NOT_FOUND | The referenced node output does not have this field. Correct the field name based on outputVariants in the node contract. |
| RPA_REFERENCE_EXPRESSION_UNSUPPORTED | ${…} can contain only a variable reference path, not arithmetic or other expressions. Write numeric calculations in a number field that supports numeric expressions (numericExpression), for example "${loop.data.index}+1". |
| RPA_INVALID_REFERENCE | The reference syntax is invalid. A ref can contain only type and content, and content must be a non-empty array of strings. A constant can contain only type and content. |
| RPA_RUNTIME_CHECK_REQUIRED | The referenced node might not run (it is inside a conditional branch or a loop). If the value is not produced at runtime, the run fails. |
| RPA_AUTHORING_RESTRICTED | This node or field contains sensitive configuration that can be edited only in the client UI. The Local API cannot write it. |
| RPA_EXTERNAL_EXECUTION_RESTRICTED | The workflow contains nodes that can run only from the client UI, so it cannot run through the Local API. |
| RPA_DEFAULT_CONFLICT | The same parameter sets both default and extra.defaultValue, and the two values differ. Keep only one of them. |
| RPA_PRIVATE_DEFAULT_CLEARED | This write did not submit a default value for the private parameter (plaintext or publicState=retained), so the existing default value will be cleared. To keep it, submit the plaintext or retained. |
| RPA_REDACTED_CONTENT_READ_ONLY | The template contains old sensitive literals that were redacted. Migrate them in the client first. Only then can you edit or copy the template through the Local API. |
| RPA_INVALID_NODE_EDIT | The node edit operation is invalid. The path in issues points to the failing operation and field. |
| RPA_UNSUPPORTED_MEDIA_TYPE | The request body must be application/json. |
| RPA_DEPENDENCY_VERSION_UNAVAILABLE | The referenced child template version is unavailable. Read the latest template, then validate again. |
| RPA_ENVIRONMENT_UNAVAILABLE | The specified browser environment cannot be resolved. Check the list of existing environments and the client state. |
| RPA_SERVICE_UNAVAILABLE | The Browser RPA service is temporarily unavailable (the client is not logged in, is starting, or has been closed). Make sure that the client is logged in, then try again. |
| RPA_REQUEST_TIMEOUT | The client timed out while processing the request, and the result is unconfirmed. For a write, query the receipt with the original idempotency key before you decide whether to retry. |