curl -X POST https://api.bota.dev/v1/devices/dev_abc123/commands \
  -H "Authorization: Bearer sk_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "type": "start_recording"
  }'

curl -X POST https://api.bota.dev/v1/devices/dev_abc123/commands \
  -H "Authorization: Bearer sk_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "type": "stop_recording"
  }'

curl -X POST https://api.bota.dev/v1/devices/dev_abc123/commands \
  -H "Authorization: Bearer sk_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "type": "trigger_upload"
  }'

// Start recording
const response = await fetch('https://api.bota.dev/v1/devices/dev_abc123/commands', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer sk_live_...',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    type: 'start_recording',
  }),
});

const command = await response.json();

import requests

# Start recording
response = requests.post(
    'https://api.bota.dev/v1/devices/dev_abc123/commands',
    headers={
        'Authorization': 'Bearer sk_live_...',
        'Content-Type': 'application/json',
    },
    json={
        'type': 'start_recording',
    },
)

command = response.json()

{
  "id": "cmd_xyz789",
  "device_id": "dev_abc123",
  "type": "start_recording",
  "status": "pending",
  "params": {},
  "grant_token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
  "result": null,
  "error": null,
  "expires_at": "2025-01-20T11:00:00Z",
  "delivered_at": null,
  "executed_at": null,
  "created_at": "2025-01-20T10:55:00Z"
}

{
  "error": {
    "code": "resource_already_exists",
    "message": "Device is already recording"
  }
}

{
  "error": {
    "code": "resource_already_exists",
    "message": "Device is not currently recording"
  }
}

{
  "error": {
    "code": "invalid_request",
    "message": "Device is offline (last seen 75s ago via wifi). Connect the device and retry."
  }
}

{
  "error": {
    "code": "resource_not_found",
    "message": "Device 'dev_abc123' not found"
  }
}