PATCH
/
public
/
user
/
proxy_user
/
edit
/
{proxy_user_id}
curl --request PATCH \
  --url https://api.pingproxies.com/1.0/public/user/proxy_user/edit/{proxy_user_id} \
  --header 'Content-Type: <content-type>' \
  --header 'X-API-Private-Key: <api-key>' \
  --header 'X-API-Public-Key: <api-key>' \
  --data '{
  "ip_address_authentications": [
    "1.1.1.1",
    "2.2.2.2"
  ],
  "proxy_user_is_service_restricted": true,
  "proxy_user_is_strict_security": false,
  "proxy_user_metadata": {
    "internal_customer_id": "94266dc6-b29f-4499-a7a8-35232d186706"
  },
  "proxy_user_password": "newPass1241233",
  "proxy_user_residential_bytes_limit": 1000000,
  "restricted_service_ids": [
    "123-4324-123",
    "123-4324-125"
  ]
}'
{
  "edited": [
    "stevejobs"
  ],
  "message": "Proxy User successfully edited."
}

Authorizations

​
X-API-Private-Key
string
header
required

Private API key for user-level authentication.

​
X-API-Public-Key
string
header
required

Public API key for user-level authentication.

Headers

​
Content-Type
string
default:application/json
required

Content type for the request body as application/json.

Path Parameters

​
proxy_user_id
string
required

ID of the proxy user record to edit.

Body

application/json
The Proxy User details to be edited.
​
ip_address_authentications
string[]

A list of valid IP addresses authenticated for this Proxy User.

Example:
["1.1.1.1", "2.2.2.2"]
​
proxy_user_is_service_restricted
boolean

Whether the Proxy User is restricted to a set of services.

Example:

true

​
proxy_user_is_strict_security
boolean

Enable or disable strict security for the Proxy User.

Example:

false

​
proxy_user_metadata
object

Arbitrary metadata object associated with the Proxy User. Constraints

  • Supports string, boolean, float and integer values.
  • Must be a non-nested JSON object.
  • Maximum 30 keys.
  • Each value's string representation ≤ 300 characters.
  • Total size ≤ 32KB.
Example:
{
  "internal_customer_id": "94266dc6-b29f-4499-a7a8-35232d186706"
}
​
proxy_user_password
string

The new password for the Proxy User. Must be alphanumeric, 10 to 32 characters.

Example:

"newPass1241233"

​
proxy_user_residential_bytes_limit
integer

The residential bytes limit for the Proxy User (must be ≥ current usage).

Example:

1000000

​
restricted_service_ids
string[]

A list of Service IDs to which the user is restricted (only if proxy_user_is_service_restricted is true).

Example:
["123-4324-123", "123-4324-125"]

Response

200 - application/json
Proxy User Successfully Edited
​
edited
string[]

List of Proxy User IDs that were successfully edited.

The Proxy User ID.

Example:
["stevejobs"]
​
message
string

Success message indicating the Proxy User was edited.

Example:

"Proxy User successfully edited."