Docs — CLOUSD

Add balance

Devices bill against a prepaid balance. Top up first, or the first create call comes back with a 402.
Create an API key

Team → API keys in the dashboard. A key is scoped read or control, covers only your devices, and is shown once. Revoke it there whenever you need to.
```
export CLOUSD_KEY=cl_live_your_key
```
Create a device

Pick a model, an Android version and where it goes online. For now this happens in the dashboard (Devices → New device); the API call is coming.
```
curl https://api.clousd.com/v1/devices/p2 \
  -H "Authorization: Bearer $CLOUSD_KEY"
```
Watch it come up

A device shows up as running with its exit country and IP. Long operations (start, stop, restart, snapshots) answer 202 with a job; poll /jobs/{id} until it is done.
```
curl https://api.clousd.com/v1/devices \
  -H "Authorization: Bearer $CLOUSD_KEY"
```

Upload an APK to a device and it installs the way it would on a phone.

curl -X POST https://api.clousd.com/v1/devices/p2/apk \
  -H "Authorization: Bearer $CLOUSD_KEY" \
  -F apk=@app.apk

Or say it in words

The AI layer reaches the same API with the same permissions. It is useful when the job is a sentence rather than a script.

“Create 10 Pixel 8 devices running Android 15.”

“Install this APK on all active devices.”

“Restart devices with connection errors.”

“Show me devices that went offline today.”

Paid, destructive and fleet-wide actions stop for confirmation. You see exactly what will happen, and what it will cost, before anything runs.

Stopping vs deletingStopping keeps everything and costs nothing. Deleting removes the device and its storage, and cannot be undone.

SnapshotsTake one before anything risky. Restoring puts the device back exactly as it was.

ProxiesSet per device, changed at any time. The device keeps running while it swaps.

Rate limitsA 429 means slow down, not stop. Retry with a backoff.