API reference

Full cloud computers your agents can see, control, and operate. Create a machine, watch its screen, click and type on it, run commands inside it, and snapshot it.

Base URL https://app.mandala.computer/api/v1

Quick start

Pick an image, make a computer, inspect its screen, act, then delete it. These examples require curl and your API key.

# 1. Pick a template.

base_url="${MANDALA_BASE_URL:-}"
if [ -z "$base_url" ]; then base_url='https://app.mandala.computer/api/v1'; fi
curl --fail-with-body "${base_url%/}"'/templates' \
  -H "Authorization: Bearer $MANDALA_API_KEY"

# 2. Create a computer. Read its id from the response.

base_url="${MANDALA_BASE_URL:-}"
if [ -z "$base_url" ]; then base_url='https://app.mandala.computer/api/v1'; fi
curl --fail-with-body -X POST "${base_url%/}"'/computers' \
  -H "Authorization: Bearer $MANDALA_API_KEY" \
  -H "Content-Type: application/json" \
  --data-raw '{"name":"scratch","template":"base","resolution":"1920x1080x24","start":true}'

# 3. Replace the illustrative computer ID below with that new id.

base_url="${MANDALA_BASE_URL:-}"
if [ -z "$base_url" ]; then base_url='https://app.mandala.computer/api/v1'; fi
curl --fail-with-body "${base_url%/}"'/computers/vm-a1b2c3d4e5f6/screenshot' \
  -H "Authorization: Bearer $MANDALA_API_KEY" \
  -o screen.png

# 4. Click in its screen coordinates.

base_url="${MANDALA_BASE_URL:-}"
if [ -z "$base_url" ]; then base_url='https://app.mandala.computer/api/v1'; fi
curl --fail-with-body -X POST "${base_url%/}"'/computers/vm-a1b2c3d4e5f6/input' \
  -H "Authorization: Bearer $MANDALA_API_KEY" \
  -H "Content-Type: application/json" \
  --data-raw '{"action":"left_click","x":640,"y":400}'

# 5. Delete the computer and its disk when no longer needed. This does not cancel or reduce a monthly subscription.

base_url="${MANDALA_BASE_URL:-}"
if [ -z "$base_url" ]; then base_url='https://app.mandala.computer/api/v1'; fi
curl --fail-with-body -X DELETE "${base_url%/}"'/computers/vm-a1b2c3d4e5f6' \
  -H "Authorization: Bearer $MANDALA_API_KEY"

Coordinates are absolute, in the screen space a computer’s resolution reports. That is the same space screenshots come back in, so a model can be handed the picture and its answer forwarded unchanged.

Using the API

Endpoints

Guides

Connecting a model or an agent framework to a computer, running Hermes and OpenClaw, moving from Orgo or E2B, hosting an agent, and troubleshooting: all guides.

API reference