Disconnect a session
POST
/api/v1/admin/sessions/{id}/disconnect
prm_users_live_traffic
Sends an RFC 5176 Disconnect-Request straight from this platform to the NAS that owns the session. The packet goes out over UDP to the device, not through the RADIUS server.
ok true means the NAS ACCEPTED the packet, not that the subscriber is off the network. Whether the session actually ends is up to the device, and it will be reflected in accounting a moment later. nak true is also a success from your point of view: the NAS replied "no such session", so it is already gone. Only a 502 means the disconnect did not happen.
At a glance
- Authentication
- Staff token or session
- Requires permission
-
prm_users_live_trafficLive traffic / disconnect - Rate limit
t_mutate
Parameters
| Parameter | Description |
|---|---|
idrequired
path · integer
|
Session id. |
Errors
| Code | When it is returned |
|---|---|
ERR_NOT_FOUND404
|
no such session, or one outside the caller's subtree |
ERR_INTERNAL502
|
the NAS did not answer, or the exchange failed. details.reason carries the transport error |
ERR_INTERNAL503
|
no CoA dispatcher is wired in this deployment |