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

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

if (response.status === 409) {
  // Something is already in flight for this device.
}

const assignment = await response.json();

import requests

response = requests.post(
    'https://api.bota.dev/v1/devices/dev_abc123/ota',
    headers={
        'Authorization': 'Bearer sk_live_...',
        'Content-Type': 'application/json',
    },
    json={'firmware_release_id': 'fw_3kQ9mZa7Rp2XvB4nT6yL8cW1'},
)

if response.status_code == 409:
    ...  # Something is already in flight for this device.

assignment = response.json()

{
  "id": "ota_7Rp2XvB4nT6yL8cW1kQ9mZa3",
  "device_id": "dev_abc123",
  "firmware_release_id": "fw_3kQ9mZa7Rp2XvB4nT6yL8cW1",
  "status": "pending",
  "assigned_at": "2026-08-14T12:00:00Z",
  "delivered_at": null,
  "applied_at": null,
  "error_message": null
}

{
  "error": {
    "code": "not_found",
    "message": "FirmwareRelease not found"
  }
}

{
  "error": {
    "code": "resource_conflict",
    "message": "Device already has a pending OTA assignment"
  }
}