---
title: "Edit Proxy User"
method: PATCH
path: "/public/user/proxy_user/edit/{proxy_user_id}"
tags: ["Proxy User"]
---

# Edit Proxy User

`PATCH /public/user/proxy_user/edit/{proxy_user_id}`

This endpoint allows a user to edit an existing Proxy User entry by providing the necessary `proxy_user_id`.

For access control, use the ProxyUserAcl endpoints to manage specific service or proxy access when using "service_restricted" or "proxy_restricted" access types.

## Path parameters

- `proxy_user_id` string, required

## Headers

- `Content-Type` string, required

## Request body

- object
  - `clear_proxy_user_acl` boolean — When changing access_type, set to True to clear all existing ProxyUserAcl entries. Required when changing to "all" if ACLs exist. Optional for other access_type changes.
  - `ip_address_authentications` string[] — A list of valid IP addresses authenticated for this Proxy User.
  - `proxy_user_access_type` 'all' | 'service_restricted' | 'proxy_restricted' — Access control type for the proxy user: - "all": Unrestricted access - "service_restricted": Access restricted by ProxyUserAcl service entries - "proxy_restricted": Access restricted by ProxyUserAcl proxy entries **Note:** Default proxy users (proxy_user_is_default=true) must always have access_type "all" and cannot be changed to restricted access types.
  - `proxy_user_enforce_https` boolean — If true, this Proxy User can only access targets on port 443 (HTTPS). This is useful for enforcing secure connections.
  - `proxy_user_is_strict_security` boolean — Enable or disable strict security for the Proxy User.
  - `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.
  - `proxy_user_mobile_bytes_limit` integer — The mobile bytes limit for the Proxy User (must be ≥ current usage).
  - `proxy_user_password` string — The new password for the Proxy User. Must be alphanumeric, 10 to 32 characters.
  - `proxy_user_residential_bytes_limit` integer — The residential bytes limit for the Proxy User (must be ≥ current usage).

## Response `200`

Proxy User Successfully Edited

- object
  - `edited` string[] — List of Proxy User IDs that were successfully edited.
  - `message` string — Success message indicating the Proxy User was edited.
  - `proxy_user_acl_deleted` string[] — List of ProxyUserAcl IDs that were deleted during the edit operation (when access_type is set to "all").

---

[API](https://skmtc.dev/byteful/apis/byteful-public-user-api.md) · [All operations](https://skmtc.dev/byteful/apis/byteful-public-user-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/byteful/byteful-public-user-api/revisions/3db1a6fc0099/schema)