Remove Reseller Service Group API

Remove service group assignments from resellers to revoke product access

Service Management

Remove Reseller Service Group API

Remove service group assignments from resellers to revoke their ability to offer specific services. Manage reseller product access effectively.

Revoke Access

Remove service group assignments.

Access Control

Manage product availability.

Realign Offerings

Adjust reseller product catalog.


Endpoint Overview

MUTATION/graphql

Remove a service group assignment from a reseller. The reseller will no longer be able to create new subscriptions using plans from this group.

Authentication:Bearer Token
Required scopes:admin

Request Parameters

resellerIdInt!Required

The unique identifier of the reseller to remove the service group from.

serviceGroupIdInt!Required

The unique identifier of the service group to remove.


GraphQL Mutation

mutation removeResellerServiceGroup($resellerId: Int!, $serviceGroupId: Int!) {
  removeResellerServiceGroup(resellerId: $resellerId, serviceGroupId: $serviceGroupId) {
    id
    email
    firstName
    lastName
    credit
    level
    serviceGroups {
      id
      name
    }
  }
}

Variables:

{
  "resellerId": 12345,
  "serviceGroupId": 100
}

HTTP Request:

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

Response

200Service Group Removed Successfully
{
  "data": {
    "removeResellerServiceGroup": {
      "id": "12345",
      "email": "partner@company.com",
      "firstName": "John",
      "lastName": "Partner",
      "credit": "1500",
      "level": "GOLD",
      "serviceGroups": [
        {
          "id": "101",
          "name": "Basic VPN Plans"
        }
      ]
    }
  }
}
400Service Group Not Assigned
{
  "errors": [
    {
      "message": "Reseller does not have this service group assigned",
      "path": ["removeResellerServiceGroup"],
      "extensions": {
        "code": "NOT_ASSIGNED"
      }
    }
  ],
  "data": null
}

When to Remove

Product Discontinuation

Service group is being phased out.

Level Downgrade

Reseller tier no longer qualifies.

Contract Change

Agreement terms have changed.

Performance Issues

Reseller not meeting requirements.


Impact of Removal

New Sales Blocked

Existing Users Unaffected

Renewals May Fail

Reporting Updated


Best Practices

Notify Reseller

Inform reseller before removing access.

Check Active Users

Review users on affected plans first.

Provide Migration Path

Offer alternatives for existing customers.

Document Reason

Record why access was revoked.



Existing Subscriptions

Removing a service group does not affect existing user subscriptions. Users will retain access until their subscription expires or is changed.

Review Reseller Assignments

View all resellers and their current service group assignments to make informed decisions.

View Resellers