List users with offset pagination and optional TanStack-style filters. To find users by telegramId, email, tag, status etc. pass filters, e.g. [{"id":"telegramId","value":123456789}]. Users are identified by numeric id.

Get all users using cursor-based (keyset) pagination with filtering options

Get user by ID

Get user by username

Get user by Short UUID

Resolve a user by EXACTLY ONE of: id, shortUuid, username

Get users tags

Which nodes a user can actually reach: per node — config profile, active squads and their inbounds. Handy for debugging squad/inbound routing.

Get user subscription request history, recent 24 records

Create a user. Credentials (vlessUuid/ssPassword/trojanPassword/shortUuid) are generated by the panel unless given — pass them explicitly for service users.

Update a user. Identify by id OR username.

Delete user

Enable user

Disable user

Revoke user subscription: rotates the subscription link (and credentials unless told otherwise)

Reset user traffic

Extend user expiration date. If user status is EXPIRED, the new expiration date is calculated from the current date and the user becomes ACTIVE. If user status is ACTIVE, the given number of days is added to the existing expiration date. DISABLED and LIMITED users will be extended, but their status will not change.

Bulk update users by User IDs

Bulk update users internal squads by User IDs

Extend expiration date for specified users by days

Bulk reset traffic users by User IDs

Revoke users subscription by User IDs

Bulk delete users by User IDs

Delete ALL users that have the given status

Update EVERY user at once

Reset used traffic for EVERY user

Extend expiration date for EVERY user by days

List all nodes. Compact by default: inbounds as tags, provider as name, system info trimmed. Pass full=true for the raw panel response, or use nodes_get for one node.

Get node by UUID

Get nodes tags

Create a new node

Update node

Delete a node

Enable a node

Disable a node

Restart node

Restart EVERY node

Reset Node Traffic

Reorder nodes

Perform actions for many nodes

Update many nodes

Modify Inbounds & Profile for many nodes

Get SECRET_KEY for Remnawave Node

Get all Node Integrations

Get Node Integration by uuid

Create Node Integration

Update Node Integration

Delete Node Integration

Get hosts

Get a host by UUID

Get tags of hosts

Create a new host

Update a host

Clone host

Delete a host by UUID

Reorder hosts

Enable hosts by UUIDs

Disable hosts by UUIDs

Update many hosts at once: the given fields (same as hosts_update) are applied to every host in uuids

Delete hosts by UUIDs

List config profiles with their inbounds and nodes. The xray config itself is left out: use config_profiles_get for one profile, or full=true.

Get config profile by uuid

Get computed config profile by uuid

Get inbounds by profile uuid

List inbounds of all config profiles (tag, type, port, squads). full=true adds the raw xray inbound objects.

Get tags of Config Profiles

Create config profile

Update a config profile: name and/or the full xray config. Nodes that use the profile restart xray to apply it.

Set tags of Config Profile

Reorder config profiles

Delete config profile

Get snippets

Create snippet

Update snippet

Sync snippet to affected config profiles. Trigger the sync of a snippet to all config profiles that reference it. Nodes which use affected config profiles will be restarted.

Delete snippet

List internal squads with their inbounds. full=true adds the raw xray inbound objects.

Get internal squad by uuid

Get internal squad accessible nodes

Get tags of Internal Squads

Create internal squad

Update internal squad

Set tags of Internal Squad

Reorder internal squads

Add many users to internal squad

Delete many users from internal squad

Add EVERY user to an internal squad. For selected users use squads_add_many_users.

Remove EVERY user from an internal squad. For selected users use squads_remove_many_users.

Delete internal squad

Get all external squads

Get external squad by uuid

Get tags of External Squads

Create external squad

Update external squad

Set tags of External Squad

Reorder external squads

Add EVERY user to an external squad

Remove EVERY user from an external squad

Delete external squad

Get user HWID devices

Get HWID devices. Please note that the filters here are primarily intended for use by the frontend and rely on expensive operators such as LIKE under the hood. Misusing these filters may negatively impact the performance of your database.

Get HWID devices stats

Get top users by HWID devices

Create a user HWID device

Delete a user HWID device

Delete all user HWID devices

Get all subscriptions

Get subscription by User ID

Get subscription by username

Get subscription by short uuid (protected route)

Get Raw Subscription by Short UUID

Get connection keys (base64 format) by user id

Get Subscription Info by Short UUID

Get all subscription request history. Please note that the filters here are primarily intended for use by the frontend and rely on expensive operators such as LIKE under the hood. Misusing these filters may negatively impact the performance of your database.

Get subscription request history stats

Get subscription settings

Update subscription settings

Get all subscription templates (wihout content)

Get subscription template by uuid

Get tags of Subscription Templates

Create subscription template

Update subscription template

Set tags of Subscription Template

Reorder subscription templates

Delete subscription template

Get all subscription page configs

Get subscription page config by uuid

Get tags of Subpage Configs

Create subscription page config

Update subscription page config

Clone subscription page config

Set tags of Subpage Config

Reorder subscription page configs

Delete subscription page config

Get all Node Plugins

Get Node Plugin by uuid

Get tags of Node Plugins

Create Node Plugin

Update Node Plugin

Clone Node Plugin

Set tags of Node Plugin

Reorder Node Plugins

Sync Node Plugin to nodes. Push the current plugin config, including referenced shared lists, to every connected node this plugin is active on.

Execute command on node plugins

Delete Node Plugin

Get Torrent Blocker Reports. Please note that the filters here are primarily intended for use by the frontend and rely on expensive operators such as LIKE under the hood. Misusing these filters may negatively impact the performance of your database.

Get Torrent Blocker Reports Stats

Truncate Torrent Blocker Reports

Get Shared Lists (Preview). Returns only the name, type and item count of every shared list. Use "Get Shared List by name" to fetch the items themselves.

Get Shared List by name

Create Shared List

Update Shared List

Sync Shared List to nodes. Push every plugin referencing this shared list to the nodes it is active on.

Delete Shared List by name

Request the active connections (IPs) of a user. Starts a job on the node(s) and returns a jobId — fetch the outcome with connections_by_user_result.

Get Connections for User by Job ID

Request the active connections on a node. Starts a job on the node(s) and returns a jobId — fetch the outcome with connections_by_node_result.

Get Connections for Node by Job ID

Check how a node's exit IP is geolocated. Starts a job on the node(s) and returns a jobId — fetch the outcome with connections_geocheck_result.

Get Geocheck for Node by Job ID

Drop Connections for Users or IPs

Get Stats

Get Recap

Get Stats Digest. Aggregated statistics for a datetime range [start, end): created and expired users, total traffic, traffic spent by users created within the range and new HWID devices. Per-user traffic history is stored with daily granularity (UTC), so the "traffic by new users" metric snaps to whole days at the range edges.

Get HTTP Stats

Get Bandwidth Stats

Get Nodes Statistics

Get Nodes Metrics

Get Nodes Usage by Range

Get Node Users Usage by Node UUID

Get Nodes Users Usage by Nodes UUIDs

Get users exceeding a traffic threshold on the given nodes for a period. Returns users whose total usage over the period on the given nodes is >= minTotalBytes. Underlying usage data is flushed to the database roughly every 2 minutes.

Get User Usage by Range

Get internal squad users traffic usage for a period. Returns users whose total usage over the period on the given nodes is >= minTotalBytes, scoped to the nodes reachable via the internal squad inbounds. Underlying usage data is flushed to the database roughly every 2 minutes.

Get a single user daily traffic usage on the internal squad nodes for a period. Returns users whose total usage over the period on the given nodes is >= minTotalBytes, scoped to the nodes reachable via the Internal Squad inbounds. Every day in the range is present (zero-filled). Underlying usage data is flushed to the database roughly every 2 minutes.

Get Remnawave Health

Get panel version and build information

Get Remnawave Configuration. Returns some of the configuration values.

Generate 30 X25519 keypairs

Validate a subscription response rules (SRR) config against the panel matcher. The body is the full responseRules config object, not an input string.

Get the status of the authentication

Get Remnawave settings

Update Remnawave settings

Get all API tokens. This endpoint is forbidden to use via "API-key". It can only be used with admin JWT-token.

Get available API token scopes. Returns the catalog of scopes that can be granted to an API token, grouped by resource. Forbidden via "API-key", admin JWT only.

Create a new API token. This endpoint is forbidden to use via "API-key". It can only be used with an admin JWT-token.

Delete API token. This endpoint is forbidden to use via "API-key". It can be used only with an admin JWT-token.

Get node metadata

Update or create Node Metadata

Get user metadata

Update or create User Metadata

Get all infra providers

Get infra provider by uuid

Create infra provider

Update infra provider

Delete infra provider by uuid

Get infra billing nodes

Create infra billing node

Update infra billing nodes

Delete infra billing node

Get infra billing history

Create infra billing history

Delete infra billing history

Send a raw request to the panel REST API with the configured token. Use it only for endpoints no dedicated tool covers. All methods are allowed.