Skip to content

Delete a residential sub-user

DELETE
/proxies/residential/subusers/{childId}
curl --request DELETE \
--url https://api.ltesocks.io/v2/proxies/residential/subusers/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0 \
--header 'Authorization: Bearer <token>' \
--header 'Idempotency-Key: example'

Requires an active linked top-level Master or Regular account and enabled residential sub-user management. Slave accounts cannot manage children. Send Authorization: Bearer . Token ability: proxy.residential.subusers.destroy (or *). Deletes the child belonging to the authenticated parent. The successful response has an empty data array.

childId
required
string format: uuid

LTESocks UUID of a sub-user belonging to the authenticated parent.

Idempotency-Key
required
string
>= 1 characters <= 255 characters

Key identifying this mutation. Use a new key for a new operation and reuse the same key and payload when retrying. A UUID is recommended; the API accepts any non-empty string up to 255 characters.

Delete a residential sub-user succeeded.

Media typeapplication/json
object
success
required
boolean
code
required
integer
data
required
Array<object>
0
object
Examples
Exampleresponse
{
"success": true,
"code": 200,
"data": []
}

Missing or invalid bearer token.

Media typeapplication/json
object
success
required
boolean
code
required
integer
message
required
string
errors

Field validation errors, when available.

object
key
additional properties
Array<string>
Example
{
"success": false,
"code": 422,
"message": "Data amount must be greater than zero."
}

Inactive or unsupported account, insufficient token ability, or child ownership denied.

Media typeapplication/json
object
success
required
boolean
code
required
integer
message
required
string
errors

Field validation errors, when available.

object
key
additional properties
Array<string>
Example
{
"success": false,
"code": 422,
"message": "Data amount must be greater than zero."
}

Sub-user or linked residential account not found, or residential sub-user management is disabled.

Media typeapplication/json
object
success
required
boolean
code
required
integer
message
required
string
errors

Field validation errors, when available.

object
key
additional properties
Array<string>
Example
{
"success": false,
"code": 422,
"message": "Data amount must be greater than zero."
}

Conflicting operation or duplicate user.

Media typeapplication/json
object
success
required
boolean
code
required
integer
message
required
string
errors

Field validation errors, when available.

object
key
additional properties
Array<string>
Example
{
"success": false,
"code": 422,
"message": "Data amount must be greater than zero."
}

Invalid input, insufficient available traffic, incompatible package, or quota limit exceeded.

Media typeapplication/json
object
success
required
boolean
code
required
integer
message
required
string
errors

Field validation errors, when available.

object
key
additional properties
Array<string>
Example
{
"success": false,
"code": 422,
"message": "Data amount must be greater than zero."
}

Request rate limit exceeded.

Media typeapplication/json
object
success
required
boolean
code
required
integer
message
required
string
errors

Field validation errors, when available.

object
key
additional properties
Array<string>
Example
{
"success": false,
"code": 422,
"message": "Data amount must be greater than zero."
}

Internal service error.

Media typeapplication/json
object
success
required
boolean
code
required
integer
message
required
string
errors

Field validation errors, when available.

object
key
additional properties
Array<string>
Example
{
"success": false,
"code": 422,
"message": "Data amount must be greater than zero."
}

Residential service failed or its result could not be read.

Media typeapplication/json
object
success
required
boolean
code
required
integer
message
required
string
errors

Field validation errors, when available.

object
key
additional properties
Array<string>
Example
{
"success": false,
"code": 422,
"message": "Data amount must be greater than zero."
}

Residential service temporarily unavailable.

Media typeapplication/json
object
success
required
boolean
code
required
integer
message
required
string
errors

Field validation errors, when available.

object
key
additional properties
Array<string>
Example
{
"success": false,
"code": 422,
"message": "Data amount must be greater than zero."
}