> For the complete documentation index, see [llms.txt](https://dronebridge.gitbook.io/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://dronebridge.gitbook.io/docs/dronebridge-for-esp32-drone-light-show-edition/developers-dlse-api-definition/ota.md).

# OTA

Over-the-air firmware and web-app updates

## Upload a new application firmware image (OTA)

> Streams a new application binary to the OTA partition and reboots into it upon successful write.<br>

```json
{"openapi":"3.0.3","info":{"title":"DroneBridge ESP32 REST API","version":"1.0.0"},"tags":[{"name":"OTA","description":"Over-the-air firmware and web-app updates"}],"servers":[{"url":"http://192.168.2.1","description":"Default ESP32 AP address"}],"paths":{"/update/firmware":{"post":{"tags":["OTA"],"summary":"Upload a new application firmware image (OTA)","description":"Streams a new application binary to the OTA partition and reboots into it upon successful write.\n","operationId":"otaFirmwareUpdate","requestBody":{"required":true,"content":{"application/octet-stream":{"schema":{"type":"string","format":"binary","description":"ESP32 application binary (db_esp32.bin)"}}}},"responses":{"200":{"description":"Firmware update accepted and device will reboot"},"400":{"description":"Bad or incomplete image"},"500":{"description":"OTA write failure"}}}}}}
```

## Upload a new web-app filesystem image (OTA)

> Streams a new SPIFFS/LittleFS web-app image to the www partition.<br>

```json
{"openapi":"3.0.3","info":{"title":"DroneBridge ESP32 REST API","version":"1.0.0"},"tags":[{"name":"OTA","description":"Over-the-air firmware and web-app updates"}],"servers":[{"url":"http://192.168.2.1","description":"Default ESP32 AP address"}],"paths":{"/update/www":{"post":{"tags":["OTA"],"summary":"Upload a new web-app filesystem image (OTA)","description":"Streams a new SPIFFS/LittleFS web-app image to the www partition.\n","operationId":"otaWwwUpdate","requestBody":{"required":true,"content":{"application/octet-stream":{"schema":{"type":"string","format":"binary","description":"ESP32 filesystem image (www.bin)"}}}},"responses":{"200":{"description":"Web-app image updated successfully"},"400":{"description":"Bad or incomplete image"},"500":{"description":"OTA write failure"}}}}}}
```