go-unifi

List Device Tags

Returns all device tags defined within a site, which can be used for WiFi Broadcast assignments. <details> <summary>Filterable properties (click to expand)</summary> |Name|Type|Allowed functions| |-|-|-| |`id`|`UUID`|`eq` `ne` `in` `notIn`| |`name`|`STRING`|`eq` `ne` `in` `notIn` `like`| |`deviceIds`|`SET(UUID)`|`contains` `containsAny` `containsAll` `containsExactly`| </details>

GET
/v1/sites/{siteId}/device-tags

Returns all device tags defined within a site, which can be used for WiFi Broadcast assignments.

NameTypeAllowed functions
idUUIDeq ne in notIn
nameSTRINGeq ne in notIn like
deviceIdsSET(UUID)contains containsAny containsAll containsExactly
X-Api-Key<token>

UniFi API key. Create one under Control Plane → Admins & Users → your admin → Create API Key (requires controller 9.0.114+).

In: header

Path Parameters

siteId*string

Query Parameters

offset?integer
limit?integer
filter?unknown

Response Body

application/json

curl -X GET "https://example.com/v1/sites/497f6eca-6276-4993-bfeb-53cbbbba6f08/device-tags"
{  "offset": 0,  "limit": 25,  "count": 10,  "totalCount": 1000,  "data": [    {      "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",      "name": "string",      "deviceIds": [        "aef9410c-f29d-4a00-9ffe-27d2e2ff353a"      ],      "metadata": {        "origin": "string"      }    }  ]}