REST API

Everything the MCP server does, over plain HTTPS. For frameworks without MCP support, CI pipelines and scripts.

Endpoints

method and path	purpose
`GET /v1/devices`	Devices available to you: name, kind, OS, access.
`POST /v1/sessions`	Request a device: `{"device":"iphone","access":"shared"}`. Returns a session.
`GET /v1/sessions/{id}/screenshot`	PNG of the current screen; `?tree=1` adds the accessibility tree.
`POST /v1/sessions/{id}/input`	tap, swipe, type, button.
`POST /v1/sessions/{id}/apps`	Install from URL or upload; launch.
`GET /v1/sessions/{id}/logs`	Logs since a timestamp.
`GET /v1/sessions/{id}/metrics`	Frame times, CPU, GPU, memory, temperature and thermal state over a window.
`POST /v1/sessions/{id}/settings`	network, locale, location.
`DELETE /v1/sessions/{id}`	Release the device.

Bearer token per workspace. Sessions have a maximum length you set; idle sessions are released automatically so you don't pay for a forgotten phone.

Early access. Base URL and token come with your wave's invite. Reserve a slot.