List all VPN users with pagination. Returns username, status, traffic usage, expiration date, and squads.

Get a single user by UUID, shortUuid, username, telegram ID, or email. Specify exactly one identifier.

Create a new VPN user. Requires username and expiration date. Returns created user details including subscription URL.

Update an existing user. Identify by UUID (preferred) or username. Only provided fields will be changed.

Permanently delete a user by UUID. This action cannot be undone.

Enable a disabled user account, restoring VPN access.

Disable a user account, suspending VPN access. Can be re-enabled later.

Revoke a user's subscription, regenerating their credentials. Old subscription links stop working.

Reset a user's traffic counter to zero.

List all XRay nodes with connection status, traffic, version info, and hardware specs.

Get detailed info about a single node by UUID.

Enable a disabled node, allowing it to accept connections.

Disable a node, stopping it from accepting new connections.

Update node settings (MUTATES PROD). Changing the config profile / inbounds re-syncs what the node serves. Only provided fields change.

Restart XRay on one node (MUTATES PROD: interrupts the node briefly). Default mode sends forceRestart (panel 2.8.0+ requires it in the body); force=true skips the config-hash check like the UI's restart-all. force_cycle=true disables and re-enables the node instead - heavier, also re-establishes the panel-node link.

Restart XRay on ALL enabled nodes. By default sends forceRestart=true so the panel skips its config-hash check; pass force=false to use the panel's hash-based decision (which often skips the restart).

List all subscription hosts with addresses, SNI, security settings, and assigned nodes.

Get detailed info about a single host by UUID.

Create a subscription host (MUTATES PROD: enabled hosts appear in user subscriptions immediately). Requires the config profile + inbound pair the host points at (UUIDs via remnawave_list_config_profiles).

Update a host (MUTATES PROD: changes flow into user subscriptions). Only provided fields change; tags/nodes replace their whole set.

Permanently delete a host (MUTATES PROD: it disappears from user subscriptions). Cannot be undone.

Get system-wide statistics: user counts by status, online stats, node count, total traffic, server CPU/memory.

Check panel health. Shows Node.js runtime metrics (RSS, heap, event loop lag, uptime) per panel process (api/scheduler/processor).

Get historical bandwidth for all nodes over a date range: per-node totals, peak days, and the fleet-wide total.

Historical per-user traffic on ONE node over a date range (daily totals + top users). Complements remnawave_get_bandwidth_stats (all nodes) and remnawave_get_node_metrics (realtime).

Get the panel's node provisioning key (SECRET_KEY env for remnanode). SENSITIVE: anyone holding this key can connect a node to the panel. Handles both field names: pubKey (<=2.8.x) and secretKey (2.9.0+).

Get real-time metrics for all nodes: users online, traffic per inbound (upload/download).

List all internal squads (inbound groups). Shows name, user count, and inbound count.

Update an internal squad (MUTATES PROD: changes which inbounds its members get). inbounds replaces the full set.

List all external squads (tariff plans). Shows name and user count.

Get global subscription settings: profile title, update interval, support link, Happ routing, custom headers.

List all XRay config profiles with their inbounds (protocol, transport, port).

Get one config profile with its FULL raw XRay config JSON (inbounds/outbounds/ routing), registered inbounds with UUIDs, and attached nodes.

Update a config profile (MUTATES PROD: replaces the XRay config that nodes run; a bad config can take user traffic down). config overwrites the whole document. Nodes apply it on their next config sync/restart.