Skip to main content
PATCH
JavaScript

Authorizations

Authorization
string
header
required

Bearer token via Authorization header

Path Parameters

id
string<uuid>
required

Body

application/json
name
string | null

New display name, up to 64 characters excluding surrounding whitespace, and containing no NUL. Send null (or an empty/whitespace-only string) to drop a custom name and go back to the generated label. Omit to leave the name unchanged.

Response

The updated proxy.

A provisioned proxy without its credentials.

country
string
required

ISO 3166-1 alpha-2 country code (lowercase).

createdAt
string<date-time>
required
host
string
required
id
string<uuid>
required
name
string
required

Display name for the proxy. Set it on create or change it with PATCH; when no name has been set, a label generated from the proxy's country, type, and id is returned instead — so this is never empty.

Example:

"🇩🇪 Germany · Dedicated residential · 769fc289"

port
integer<int32>
required
status
enum<string>
required

Lifecycle of a proxy. A freshly created proxy is checking while its billing identity is being resolved — clients should poll until a paymentUrl or a later status appears — then provisioning — or pending_payment until the customer completes checkout — and becomes active once its upstream is assigned. cancelling retains full access through the paid period; when the subscription expires the proxy is ended. error marks a failed provisioning attempt.

Available options:
checking,
pending_payment,
provisioning,
active,
cancelling,
ended,
error
type
enum<string>
required
Available options:
dedicated_residential,
residential,
mobile
username
string
required
billingMode
enum<string>
Available options:
included,
standalone_paid