Browser options
Choose an agent browser or a browser for a person. The published API has no image catalog.
Select a browser at session creation
Use the browser field when creating a session. There are no documented operating-system image or size fields.
Browser selections
| Parameter | Type | Description |
|---|---|---|
agent | Automation | Hosted browser controlled through the API or MCP. Supports human handoff and uses a residential exit. |
chrome | Human-operated | Shield browser for a person to open through view_url. |
brave | Human-operated | Shield browser for a person to open through view_url. |
firefox | Human-operated | Shield browser for a person to open through view_url. |
tor | Human-operated | Shield browser for a person to open through view_url. |
Human-operated Shield sessions use Legba's own address. They do not use the agent browser's residential exit. The API cannot drive these human-operated browsers.
Open a browser for a person
curl --fail-with-body --silent --show-error \
-X POST "https://skill.legba.xyz/api/v1/sessions" \
-H "Authorization: Bearer $LEGBA_API_KEY" \
-H 'Content-Type: application/json' \
-d '{"kind":"browser","country":"US","browser":"chrome"}'Give the returned view_url to the intended person. Do not attempt navigation or handoff API calls. Those actions belong to browser: agent.
Keep the returned session ID for cleanup. Follow the session deletion reference when finished.
Local browser choices
The skill also includes local rendering clients. render.mjs uses Playwright Chromium. antibot.py uses Camoufox Firefox.
These browsers run on your machine. Install their dependencies before using them. They are separate from hosted browser selection.
See the local rendering recipe for setup and usage.
Image catalog availability
The published repository contains no image-listing endpoint. It also defines no custom-image upload contract. Use the documented browser selection values above.
For requirements outside this contract, Contact us. Do not build against an assumed image catalog.