API — Profiles, presets & routing

List and import identities, manage presets and domain routing rules, and register the gateways your ports route through.

Profiles

GET /api/v1/profiles Auth required

Lists stored identities, with optional paging and a browser filter.

Parameter	Type	Required	Description
`limit`	`int (query)`	No	Page size (default 100).
`offset`	`int (query)`	No	Page offset (default 0).
`browser`	`string (query)`	No	Filter by browser, e.g. "chrome".

Example (curl)

curl -H "X-API-Key: YOUR_API_KEY" "http://127.0.0.1:8891/api/v1/profiles?browser=chrome&limit=50"

GET /api/v1/counts Auth required

Returns how many identities exist per browser family.

Example (curl)

curl -H "X-API-Key: YOUR_API_KEY" http://127.0.0.1:8891/api/v1/counts

Response

{ "Chrome": 10000, "Firefox": 500, "Safari": 300, "Edge": 200 }

POST /api/v1/port/{port}/rotate Auth required

Rotates a port to a different identity within its current filters.

Example (curl)

curl -H "X-API-Key: YOUR_API_KEY" -X POST http://127.0.0.1:8891/api/v1/port/20134/rotate

GET /api/v1/port/{port}/profile/view Auth required

Returns the full identity a port is currently presenting.

Example (curl)

curl -H "X-API-Key: YOUR_API_KEY" http://127.0.0.1:8891/api/v1/port/20134/profile/view

Presets save and re-apply port configurations, organized into folders.

GET /api/v1/presets Auth required

Lists saved presets and folders.

POST /api/v1/presets Auth required

Saves a preset.

POST /api/v1/presets/load Auth required

Loads a preset onto a port.

DELETE /api/v1/presets Auth required

Deletes a preset.

GET /api/v1/domain_rules Auth required

Returns the ordered list of domain routing rules.

PUT /api/v1/domain_rules Auth required

Replaces the domain routing rules. Each rule matches domains and sends them through a chosen route with optional spoofing overrides.

GET /api/v1/ovpn Auth required

Lists saved gateways and their tunnel status.

POST /api/v1/ovpn Auth required

Adds a gateway (an .ovpn file or a vless:// link).

PUT /api/v1/ovpn/{name} Auth required

Updates an existing gateway.

DELETE /api/v1/ovpn/{name} Auth required

Deletes a gateway (refused if it is in use).

GET /api/v1/gateway/openvpn-status Auth required

Reports whether the OpenVPN/VLESS backend is available on the host.