This guide shows you how to update a sub-user package, manage its lists, or delete it.
Every request uses your personal API key from your account dashboard (how to get your API key). In the examples below, replace YOUR_API_KEY with your own key. To pay from your account balance, use paymentId = 1.
Step 1 — List the sub-user packages
List the sub-user packages and copy the package_key to work with.
Endpoint
GET https://proxy-seller.com/personal/api/v1/YOUR_API_KEY/residentsubuser/packages
Response
{
"status": "success",
"data": [
{ "package_key": "ab12cd34ef56", "traffic_limit": "1073741824", "is_active": true, "expired_at": "d.m.Y" }
],
"errors": []
}
Step 2 — Update the package
Update the package: change traffic limit, rotation, expiry, or turn it on/off with is_active.
Endpoint
POST https://proxy-seller.com/personal/api/v1/YOUR_API_KEY/residentsubuser/update
Request body
Name | Type | Description |
package_key | String | Package key (from package info). |
traffic_limit (optional) | String | Traffic limit in bytes. |
rotation (optional) | Number | Rotation: |
expired_at (optional) | String | Expiry date of the package. |
is_active (optional) | Boolean | Boolean — |
is_link_date (optional) | Boolean | Boolean — link the expiry to the main package. |
Response
{
"status": "success",
"data": {
"package_key": "ab12cd34ef56",
"rotation": 60,
"traffic_limit": "1073741824",
"is_active": true
},
"errors": []
}
Step 3 — Manage the package lists
List the lists in the package, then rename a list (id + title + package_key) or delete one by its listId.
Endpoint
GET https://proxy-seller.com/personal/api/v1/YOUR_API_KEY/residentsubuser/lists
Response
{
"status": "success",
"data": [
{ "id": 7788, "title": "Client A", "login": "x1y2z3", "package_key": "ab12cd34ef56" }
],
"errors": []
}
Endpoint — rename
POST https://proxy-seller.com/personal/api/v1/YOUR_API_KEY/residentsubuser/list/rename
Name | Type | Description |
id | Number | List id. |
title | String | The new title for the list. |
package_key | String | Package key (from package info). |
Endpoint — delete list
DELETE https://proxy-seller.com/personal/api/v1/YOUR_API_KEY/residentsubuser/list/delete
Step 4 — Or delete the whole package
Delete the whole sub-user package by its package_key. This is irreversible.
Endpoint
DELETE https://proxy-seller.com/personal/api/v1/YOUR_API_KEY/residentsubuser/delete
Request body
Name | Type | Description |
package_key | String | Package key (from package info). |
Response
{
"status": "success",
"data": { "deleted": true },
"errors": []
}