API reference
Upload builds and manage workspaces programmatically.
Authentication
All requests are scoped to an organisation and authenticated with an API key created in Settings & Billing → API keys.
curl https://api.spawndroid.io/v1/apps \
-H "Authorization: Bearer spawn_live_..."POST /v1/apps
Upload an APK and register it as an app version.
| Field | Type | Notes |
|---|---|---|
file | multipart | The .apk. Max 500 MB. |
device | string | pixel8 | s24 | flat |
autoplay | boolean | Start the stream on load |
timeout | string | 1m | 3m | 10m | unlimited |
Returns the created app plus its previewUrl.
Webhooks
Clerk delivers organisation lifecycle events to /api/webhooks/clerk, verified
with Svix. On organization.created the tenant is provisioned on the Free
tier — 50 minutes, 0 used.