FLAG OVERRIDES

Per-request flag overrides

Append flags to your proxy username to change routing and identity per request — without changing your dashboard defaults. This page lists the flags you can set and the exact rule for which value wins.

Overview

How overrides work

Your dashboard holds your default settings. For a single request you can override them by appending flags to your proxy username. The brain merges your per-request flags with your defaults and resolves exactly one value per flag. Spoof inputs such as tls and ua only emit when spoofing is enabled for your subscription.

Flags

Per-request flags

countryTarget one or more countries (e.g. us, de). Lists replace, they do not add up.

country_excludeAvoid a country (written as not-us); excludes and a positive list can coexist.

cityTarget a city; only takes effect alongside a country.

ispTarget a specific ISP; only takes effect alongside a country.

regionTarget a geographic region.

asnTarget a specific network (autonomous system number).

sessionPin the same exit IP across requests by reusing a session id.

stickytimeHow long to keep the same exit IP before it rotates.

udpRequest a UDP-capable exit (set udp=true) for UDP workloads.

uptimePrefer exits with a minimum continuous uptime.

deviceTarget a device type.

osTarget an operating system; also shapes your spoofed identity when spoofing is on.

tlsChoose a TLS fingerprint profile. Spoof input — only emitted when spoofing is enabled for your subscription.

uaChoose a User-Agent. Spoof input — only emitted when spoofing is enabled for your subscription.

Delimiters

Two delimiter styles

Pick one style and use it consistently — you cannot mix the two in a single username.

Dash style

Append flags after your username as -key-value pairs.

myuser-country-de-session-abc123

Semicolon style

Append flags after your username as ;key=value pairs.

myuser;country=de;session=abc123

Precedence

Which value wins

Highest precedence first. Lists replace your default for that flag — they do not concatenate.

1.
-none (explicit removal)
Highest precedence: explicitly removes a flag so nothing else can set it.
2.
Per-request basic-auth value
A value you append to the username for this request overrides your dashboard default.
3.
Dashboard default
Your saved default applies when you do not set the flag for this request.
4.
Omitted
If no source sets the flag, it is left off entirely.

Examples

Worked examples

Per-request beats your dashboard default

Dashboard default country=us, request adds country-de

Resolves to: de

-none removes a flag entirely

Dashboard default country=us, request adds country-none

Resolves to: removed (no country sent)

Absent everywhere is omitted

No dashboard default and nothing on the request

Resolves to: omitted (flag left off)

FAQ

Frequently asked

Only when spoofing is enabled for your subscription. With spoofing off, those inputs are ignored and your traffic is relayed as-is.

No. Pick one style — all dash, or all semicolon. Mixing them is rejected.

No. Lists replace your default for that flag; they never concatenate.