Mist API Reference
Mist Automation Guide
HomeSDKsAPI ReferenceContext Plugin
SitesClientsNAC

sendSiteNacClientCoA

POST
/api/v1/sites/{site_id}/nac_clients/{client_mac}/coa

Sends CoA (Change of Authorization) command to a NAC client.

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
client_mac*string
Match^[0-9a-fA-F]{12}$

Request Body

application/json

Request Body

Change of Authorization request for a NAC client

coa_type?nac_coa_type

Change of Authorization command to send to the NAC client. enum: reauth, disconnect.

Default"reauth"

Value in

  • "reauth"
  • "disconnect"

Response Body

curl -X POST "https://example.com/api/v1/sites/000000ab-00ab-00ab-00ab-0000000000ab/nac_clients/0000000000ab/coa" \  -H "Content-Type: application/json" \  -d '{}'
{  "device_mac": "string",  "device_type": "ap"}

searchSiteNacClients GET

Search NAC clients for a site with filters for authentication, endpoint posture, identity, network, NAC rule, and time attributes. Use [Search Org NAC Clients](/api/mist/orgs/orgs-clients/orgs-clients---nac/searchOrgNacClients) to search NAC clients across the organization.

countSiteWanClientEvents GET

Count WAN client events for a site, optionally grouped by the `distinct` field and filtered by event type and time range. Use [Count Org WAN Client Events](/api/mist/orgs/orgs-clients/orgs-clients---wan/countOrgWanClientEvents) to count WAN client events across the organization.