API Reference
OIDC
Platform

Radius Clients

AdminUpdated Sep 11, 2026

Radius Clients

Backend API — secret key (Authorization: Bearer sk_…).

5 routes. Each row is one endpoint with its explanation, required scope, and whether it honours the Idempotency-Key header.

Method & path

Scope

Idem

Explanation

GET /v1/radius_clients

radius_clients:read

List the RADIUS NAS clients — the VPN/WiFi/firewall devices allowed to authenticate this instance's users over RADIUS. The per-NAS shared secret is never returned, only whether one is set.

POST /v1/radius_clients

radius_clients:write

Register a RADIUS NAS client (name, NAS-Identifier, optional source-IP bind, write-only shared secret). The NAS-Identifier is unique across the deployment; a duplicate is a 409.

GET /v1/radius_clients/:id

radius_clients:read

Read one RADIUS NAS client. The shared secret is never included.

PATCH /v1/radius_clients/:id

radius_clients:write

Update a RADIUS NAS client's name, NAS-Identifier, source-IP bind, enabled flag or shared secret. An omitted or empty shared_secret keeps the stored one.

DELETE /v1/radius_clients/:id

radius_clients:write

Delete a RADIUS NAS client. That NAS can no longer authenticate against the listener.

Was this page helpful?