Disassociate Wireless Clients

To disassociate wireless clients on the device making the REST API calls, a remote device, or rf-domain:

  1. Log in to the REST API server using valid management user credentials.
    Note

    Note

    You must forward the auth_token as a cookie with each API call.
  2. Use the POST method to access the /act/disassociate-client/ URI.
    Note

    Note

    The WiNG API, in its current form does not differentiate between PUT and POST methods. The API behaves the same way for both requests.

    Sample Requests with Different Possible Input Parameters

    curl -X POST --cookie auth_token=$cookie http://172.16.0.16/rest/v1/act/disassociate-client 
    -d
      '{"client_mac":"all"}'
        

    Disassociate the wireless client with the given MAC address on the device

    curl -X POST --cookie auth_token=$cookie http://172.16.0.16/rest/v1/act/disassociate-client 
    -d
       '{"client_mac":"D0-04-01-3B-01-70"}'

    Disassociate the wireless clients in the given WLAN on the device

    curl -X POST --cookie auth_token=$cookie http://172.16.0.16/rest/v1/act/disassociate-client
    -d
        '{"wlan_name":"testwlan"}'

    Disassociate all wireless clients on the remote device with the given mac address

    curl -X POST --cookie auth_token=$cookie http://172.16.0.16/rest/v1/act/disassociate-client
    -d 
        '{"device":"74-67-F7-5C-21-D8","client_mac":"all"}'

    Disassociate the wireless client with a given MAC address on the rf-domain

    curl -X POST --cookie auth_token=$cookie http://172.16.0.16/rest/v1/act/disassociate-client
    -d
        '{"rf-domain":"guest-domain","client_mac":"D0-04-01-3B-01-70"}'

    Sample Response (200 OK)

    {    
    "return_code": 0
    }