curl -X DELETE https://api.bota.dev/v1/devices/dev_abc123/ota \
  -H "Authorization: Bearer sk_live_..."

const response = await fetch('https://api.bota.dev/v1/devices/dev_abc123/ota', {
  method: 'DELETE',
  headers: { 'Authorization': 'Bearer sk_live_...' },
});

if (response.status === 404) {
  // Nothing was in flight.
} else {
  const cancelled = await response.json();
  if (cancelled.delivered_at) {
    // The device already had it; it may still install.
  }
}

import requests

response = requests.delete(
    'https://api.bota.dev/v1/devices/dev_abc123/ota',
    headers={'Authorization': 'Bearer sk_live_...'},
)

if response.status_code == 404:
    ...  # Nothing was in flight.
else:
    cancelled = response.json()
    if cancelled['delivered_at']:
        ...  # The device already had it; it may still install.

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

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

{
  "error": {
    "code": "not_found",
    "message": "OTA assignment not found"
  }
}