Docs

Gateway API

Connect your agent to a Murable cloud computer through its protected gateway. It can read screen elements, click controls, work with files and use the browser. The browser also supports the standard Chrome DevTools Protocol (CDP) for existing automation tools.

Authentication

Use the gateway address shown in the panel. It stays the same when a computer stops, and the next request wakes that computer. Include the gateway key as a bearer token in every request.

Base URL   https://app.murable.ai/gw/{computer_id}

Authorization: Bearer <gateway_key>
Add each path below to the base URL, for example GET https://app.murable.ai/gw/{computer_id}/computer/tree. View or regenerate your gateway key in the panel. Browser access goes through this gateway; direct CDP access is not public.

Available requests

See
MethodPathDescription
GET/computer/tree?app=…read screen elements as {role,name,bbox,text}; use this before taking a screenshot
POST/computer/capturetake a PNG screenshot when the element tree is not enough
Act
MethodPathDescription
POST/computer/click_elementclick a menu or dialog item by {name}
POST/computer/clickclick at {x,y}
POST/computer/double_clickdouble-click at {x,y}
POST/computer/movemove cursor to {x,y}
POST/computer/typetype {text}
POST/computer/keypress {key}, for example "Enter" or "ctrl+c"
POST/computer/dragdrag {start_x,start_y,end_x,end_y}
POST/computer/scrollscroll {direction,amount}
POST/computer/waitpause {seconds} (≤60)
GET/computer/windowslist open windows
POST/computer/focusfocus a window {app}
Files & shell
MethodPathDescription
POST/computer/bashrun a shell command {command} (user abc)
POST/computer/execrun Python {code}
GET/files/list?path=…list a directory
GET/files/read?path=…read raw file bytes
POST/files/writewrite a file {path, content | content_b64}
DELETE/files/delete?path=…delete a file / directory
Browser (CDP)
MethodPathDescription
CDP/cdp/<key>Chrome DevTools address for /browser connect or Playwright --cdp-endpoint

Browser Use over CDP

Connect to the built-in cloud browser at /cdp/<gateway_key> using Chrome DevTools Protocol (CDP). The connection uses a WebSocket. Existing tools can connect with Playwright connectOverCDP or --cdp-endpoint, Puppeteer connect({ browserWSEndpoint }), or Browser Use /browser connect. The gateway protects the connection with the same access key and wakes the computer when needed.