> 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/clients.md).

# Clients

Manage active UDP client connections

## Add a UDP client connection

> Registers a new UDP destination (IPv4 address + port). The ESP32 will start forwarding serial data to this endpoint immediately. Optionally persists the entry to NVM so it survives reboots.<br>

```json
{"openapi":"3.0.3","info":{"title":"DroneBridge ESP32 REST API","version":"1.0.0"},"tags":[{"name":"Clients","description":"Manage active UDP client connections"}],"servers":[{"url":"http://192.168.2.1","description":"Default ESP32 AP address"}],"paths":{"/api/settings/clients/udp":{"post":{"tags":["Clients"],"summary":"Add a UDP client connection","description":"Registers a new UDP destination (IPv4 address + port). The ESP32 will start forwarding serial data to this endpoint immediately. Optionally persists the entry to NVM so it survives reboots.\n","operationId":"addUdpClient","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UdpClientRequest"}}}},"responses":{"200":{"description":"Result of the add operation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StatusResponse"}}}},"400":{"description":"Request body too large","content":{"text/plain":{"schema":{"type":"string"}}}},"500":{"description":"Internal server error while receiving data","content":{"text/plain":{"schema":{"type":"string"}}}}}}}},"components":{"schemas":{"UdpClientRequest":{"type":"object","required":["ip","port"],"properties":{"ip":{"type":"string","format":"ipv4","description":"IPv4 address of the UDP destination"},"port":{"type":"integer","minimum":1,"maximum":65535,"description":"UDP destination port"},"save":{"type":"boolean","description":"If `true`, persist this client to NVM so it is restored after a reboot. Only one entry can be persisted at a time.\n","default":false}}},"StatusResponse":{"type":"object","description":"Generic status/message response used by several endpoints","properties":{"status":{"type":"string","enum":["success","failed"]},"msg":{"type":"string"}}}}}}
```

## Remove all UDP client connections

> Clears the entire in-memory UDP client list and erases the single persisted UDP client from NVM. Ground-control software will need to re-register after this call.<br>

```json
{"openapi":"3.0.3","info":{"title":"DroneBridge ESP32 REST API","version":"1.0.0"},"tags":[{"name":"Clients","description":"Manage active UDP client connections"}],"servers":[{"url":"http://192.168.2.1","description":"Default ESP32 AP address"}],"paths":{"/api/settings/clients/clear_udp":{"delete":{"tags":["Clients"],"summary":"Remove all UDP client connections","description":"Clears the entire in-memory UDP client list and erases the single persisted UDP client from NVM. Ground-control software will need to re-register after this call.\n","operationId":"clearUdpClients","responses":{"200":{"description":"All UDP clients removed successfully","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StatusResponse"}}}}}}}},"components":{"schemas":{"StatusResponse":{"type":"object","description":"Generic status/message response used by several endpoints","properties":{"status":{"type":"string","enum":["success","failed"]},"msg":{"type":"string"}}}}}}
```


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://dronebridge.gitbook.io/docs/dronebridge-for-esp32-drone-light-show-edition/developers-dlse-api-definition/clients.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.