In order to delete a user from the list of currently authenticated users, the REST API client must send an HTTP DELETE to the URI /api/oper/userauth. The action can have the following parameters:

For example, to remove a user with the IP address 192.168.1.201, send a DELETE command to the URI:

/api/oper/userauth?ip=192.168.1.201

The Content-Type for this should be application/x-www-form-urlencoded.

The following JSON reply will be sent back by cOS Core if the deletion is successful:

{
  "error": false
}

If the user was not found, cOS Core will return the following JSON message:

{
  "error": true,
  "error_code": 404,
  "error_message": "User does not exist"
}

The above message indicates that there is no user with the given IP address (and optionally the given interface) is currently authenticated.