Reseller Delete User API

Allow resellers to delete user accounts by user ID

Reseller

Reseller Delete User API

Permanently delete user accounts from your reseller group. Remove users who have cancelled, violated terms, or are no longer needed.

Remove Users

Delete user accounts.

Clean Data

Remove all user data.

Group Scoped

Only your users deletable.


Endpoint Overview

MUTATION/graphql

Delete a user from your reseller group by their unique ID. This permanently removes the user and all associated data.

Authentication:Bearer Token
Required scopes:reseller

Request Parameters

idInt!Required

The unique identifier of the user to delete.


GraphQL Mutation

mutation resellerDeleteUser($id: Int!) {
  resellerDeleteUser(id: $id) {
    id
    email
    username
    resellerId
  }
}

Variables:

{
  "id": 12345
}

HTTP Request:

curl -X POST https://api.orbnet.com/graphql \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_RESELLER_TOKEN" \
  -d '{
    "query": "mutation resellerDeleteUser($id: Int!) { resellerDeleteUser(id: $id) { id email } }",
    "variables": {
      "id": 12345
    }
  }'

Response

200User Deleted Successfully
{
  "data": {
    "resellerDeleteUser": {
      "id": "12345",
      "email": "deleted_customer@example.com",
      "username": "deleteduser",
      "resellerId": "reseller_789"
    }
  }
}
400User Not Found
{
  "errors": [
    {
      "message": "User with ID 12345 not found or not in your group",
      "path": ["resellerDeleteUser"],
      "extensions": {
        "code": "NOT_FOUND"
      }
    }
  ],
  "data": null
}

What Gets Deleted

Account

User login and credentials.

Profile

All personal information.

Devices

Device registrations cleared.

Sessions

Active connections terminated.


When to Delete

Cancellation

Customer cancelled subscription.

Terms Violation

User violated service terms.

Request

User requested account deletion.

Cleanup

Remove test or inactive accounts.


Best Practices

Confirm First

Verify deletion is intended.

Consider Disable

Disable instead of delete when unsure.

Export Data

Backup user data if needed.

Document Reason

Record why user was deleted.



Irreversible Action

User deletion is permanent. The account and all associated data cannot be recovered. Consider disabling the account instead if you may need to restore access later.

Delete by Email Instead?

If you only have the user's email address, use the Delete by Email endpoint.

Delete by Email