Delete Reseller API

Permanently remove reseller accounts and associated data from the system

Reseller Management

Delete Reseller API

Permanently remove a reseller account from the system. This action deletes all associated data and cannot be undone.

Permanent Removal

Delete reseller completely.

Data Cleanup

Remove all associated data.

Access Revoked

Immediately revoke all access.


Endpoint Overview

MUTATION/graphql

Delete an existing reseller by ID. This permanently removes the reseller and all associated data.

Authentication:Bearer Token
Required scopes:admin

Request Parameters

idInt!Required

The unique identifier of the reseller to delete.


GraphQL Mutation

mutation deleteReseller($id: Int!) {
  deleteReseller(id: $id) {
    id
    email
    firstName
    lastName
  }
}

Variables:

{
  "id": 12345
}

HTTP Request:

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

Response

200Reseller Deleted Successfully
{
  "data": {
    "deleteReseller": {
      "id": "12345",
      "email": "deleted@company.com",
      "firstName": "John",
      "lastName": "Partner"
    }
  }
}
400Reseller Not Found
{
  "errors": [
    {
      "message": "Reseller with ID 12345 not found",
      "path": ["deleteReseller"],
      "extensions": {
        "code": "NOT_FOUND"
      }
    }
  ],
  "data": null
}
400Active Users Exist
{
  "errors": [
    {
      "message": "Cannot delete reseller with active users",
      "path": ["deleteReseller"],
      "extensions": {
        "code": "HAS_ACTIVE_USERS"
      }
    }
  ],
  "data": null
}

What Gets Deleted

Account Data

All reseller profile and login information.

Credit Balance

Any remaining credit balance is forfeited.

Service Groups

All service group assignments removed.

Access Tokens

All API tokens and sessions invalidated.


Pre-Deletion Checklist

Review Users

Export Data

Settle Balance

Notify Reseller


Best Practices

Backup First

Export reseller data before deletion.

Check Dependencies

Ensure no active users under reseller.

Document Reason

Record why the reseller was removed.

Confirm Action

Double-check before executing.



Irreversible Action

Deletion is permanent. Once deleted, all reseller data cannot be recovered. Make sure to backup any necessary information before proceeding.

Consider Deactivation Instead

If you may need to restore access later, consider editing the reseller to disable access rather than deleting permanently.

Edit Reseller