Proxies

Pause or resume a proxy

Only enabled can change. Pausing or resuming clears last_error and its error history, and a resumed proxy is checked again at once, so this also brings back a proxy that was switched off after failing. To change the host, port or credentials, delete the proxy and add it again.

patch/v1/proxies/{id}

Request

  • Base URL: https://api.feelingsurf.fr
  • URL: https://api.feelingsurf.fr/v1/proxies/{id}
  • Auth: HTTP bearer

Path parameters

idinteger required

Resource identifier.

Request body

enabledboolean required

False pauses the proxy, true resumes it.

Response

The updated proxy.

idinteger

Unique identifier.

type'http' | 'https' | 'socks5'

The proxy protocol.

hoststring

The proxy's public IP address.

portinteger

The proxy's port.

usernamestring nullable

The username sent to the proxy, or null.

has_passwordboolean

Whether a password is stored for the proxy.

enabledboolean

False when you paused the proxy, or when it was switched off after failing (see last_error).

provenboolean

Whether a check through FeelingSurfViewer has confirmed the proxy works at least once. Sessions never go through an unproven proxy, but a proven one can still sit unused, for instance while unanswered is true or shortly after an error.

unansweredboolean

The proxy failed its latest check and is set aside until a new check succeeds.

visitsinteger

Visits made through the proxy.

credits_earntnumber float

Credits earned through the proxy.

last_used_atstring date-time nullable

When a visit last went through the proxy (UTC), or null.

last_errorstring nullable

The latest error code for the proxy, e.g. ERR_PROXY_CONNECTION_FAILED, or null.

last_error_atstring date-time nullable

When last_error happened (UTC), or null.

created_atstring date-time

When the proxy was added (UTC).

Example response

{
  "id": 4821,
  "type": "http",
  "host": "203.0.113.10",
  "port": 8080,
  "username": "exit-eu",
  "has_password": true,
  "enabled": true,
  "proven": true,
  "unanswered": false,
  "visits": 312,
  "credits_earnt": 47.25,
  "last_used_at": "2026-09-12T09:14:03Z",
  "last_error": null,
  "last_error_at": null,
  "created_at": "2026-09-10T18:22:47Z"
}

Changes

No recorded changes to this operation across all 1 revision of this API.