The Browser RPA Local API is served by MoreLogin desktop client V2.73.0 or later at http://127.0.0.1:<port>/api/rpa/browser/v1. Use the Local API port shown in the client settings; 40000 is the default.
Authentication works the same way as for the rest of the Local API; see Authentication. Send JSON bodies with Content-Type: application/json. A success response is {data,meta} and an error response is {error,meta}. Authentication failures use the standard Local API 401 format. Handle failures by HTTP status, error.code, details, and issue paths, not by message text. API conventions describes the full rules.
Idempotency-Key is optional, but without it a retry after a timeout can repeat the write. Generate a new UUID for each new write intent, and keep it together with the method, path, body, and If-Match until you know the outcome. If-Match takes the exact ETag returned by Get a template. X-RPA-Catalog-Revision takes data.catalogRevision from Get capabilities. Validate a workflow is read-only, needs none of these headers, and leaves no request receipt.
Local machine-readable contract
Read /openapi.json at the local base URL for the HTTP contract. The workflow schema URL is in data.docs.schema from GET /capabilities.
Edit an existing template
Read the latest template and the contracts of the nodes you will edit. For local changes, apply the proposed node edits to the complete tree and validate with purpose:"save", source.kind:"inline", and source.base:{templateId,version}. Submit the operations with node-edits after the candidate passes. A batch either saves one new version or changes nothing. Send complete nodes and blocks when you replace them, and repair references when you remove nodes. Use PUT to replace the whole template. Record child template dependencies as their current {processId,revisionId}, and read the dependencies again after a version conflict.
Recovery
Situation
Next step
Write timeout, connection loss, or uncertain outcome
Query GET /requests/{originalKey}. For completed, use the original result; a completed run registration still needs a run-status check. Poll accepted or committed within a bounded time. For unknown, an ordinary 404, or an expired receipt, stop automatic writes and check the resource.
RPA_REQUEST_NOT_COMMITTED with safeToRetrySameKey=true
Retry the same intent with the original key, method, path, body, and If-Match, if any.
412 version conflict
Check the receipt first. After you confirm that the write did not commit, read the template again, merge, validate, and submit with a new key and the current ETag.
Catalog changed
Check the receipt and confirm that the write did not commit, then refresh capabilities and contracts. If the body and If-Match stay the same, refresh the catalog header and keep the original key.
valid=false or a deterministic input error
Fix the reported path and validate again. If the write was recorded as failed, confirm that nothing was committed before you use a new key. On 429 or 503, follow Retry-After and the receipt rules.