Mist API Reference
Mist Automation Guide
HomeSDKsAPI ReferenceContext Plugin
SitesDevices

setSiteDevicesGbpTag

POST
/api/v1/sites/{site_id}/devices/gbp_tag

Set GBP Tag for multiple devices

Authorization

Authorization<token>

Preferred authentication method for automation and integrations. Send the API token in the HTTP Authorization header.

Format: Authorization: Token {apitoken}

Notes:

  • An API token generated for a specific admin has the same privileges as that admin
  • An API token is automatically removed if it is not used for more than 90 days
  • SSO admins cannot generate admin API tokens. Use organization API tokens when scoped Org/Site privileges are needed.

In: header

Path Parameters

site_id*string
Formatuuid

Request Body

application/json

Request Body

Request body for assigning a GBP tag to multiple devices

gbp_tag*integer

Group-Based Policy tag value to apply to the devices

macs*array<string>

Device MAC addresses that receive the GBP tag

Items1 <= items

Response Body

curl -X POST "https://example.com/api/v1/sites/000000ab-00ab-00ab-00ab-0000000000ab/devices/gbp_tag" \  -H "Content-Type: application/json" \  -d '{    "gbp_tag": 0,    "macs": [      "683b679ac024"    ]  }'
Empty

searchSiteDevices GET

Search devices in a site with filters for device type, identifiers, model, software version, radio settings, LLDP details, and other inventory attributes. Use [Search Org Devices](/api/mist/orgs/orgs-devices/searchOrgDevices) to search devices across the organization.

countSiteOtherDeviceEvents GET

Count third-party device events for a site, optionally grouped by the `distinct` field and filtered by event type and time range. Use [Count Org Other Device Events](/api/mist/orgs/orgs-devices/orgs-devices---others/countOrgOtherDeviceEvents) to count third-party device events across the organization.