Reseller Deactivate Device API
Allow resellers to deactivate and remove devices from users they manage
Reseller Deactivate Device API
Enable resellers to remove devices from their managed users' accounts. Revoke VPN access and free up device slots for customer management.
Device Removal
Remove devices from user accounts.
Access Revocation
Immediately prevent device from connecting.
Slot Recovery
Free up device slots for new registrations.
Endpoint Overview
/graphqlDeactivate a device for a user managed by the authenticated reseller. The device will be removed from the user's account.
Request Parameters
userIdInt!RequiredThe unique identifier of the user (must be under reseller's management).
deviceIdInt!RequiredThe unique identifier of the device to deactivate.
GraphQL Mutation
mutation resellerDeactivateDevice($userId: Int!, $deviceId: Int!) {
resellerDeactivateDevice(userId: $userId, deviceId: $deviceId)
}Variables:
{
"userId": 12345,
"deviceId": 67890
}HTTP Request:
curl -X POST https://api.orbnet.com/graphql \
-H "Content-Type: application/json" \
-H "Authorization: Bearer YOUR_RESELLER_TOKEN" \
-d '{
"query": "mutation resellerDeactivateDevice($userId: Int!, $deviceId: Int!) { resellerDeactivateDevice(userId: $userId, deviceId: $deviceId) }",
"variables": {
"userId": 12345,
"deviceId": 67890
}
}'Response
{
"data": {
"resellerDeactivateDevice": true
}
}{
"errors": [
{
"message": "User is not under your management",
"path": ["resellerDeactivateDevice"],
"extensions": {
"code": "FORBIDDEN"
}
}
],
"data": null
}{
"errors": [
{
"message": "Device not found or already deactivated",
"path": ["resellerDeactivateDevice"],
"extensions": {
"code": "DEVICE_NOT_FOUND"
}
}
],
"data": null
}When to Deactivate
Lost Devices
Remove access from lost or stolen customer devices.
Device Replacement
Remove old device to make room for new hardware.
Account Cleanup
Remove unused devices from customer accounts.
Security Concerns
Quickly revoke access after suspicious activity.
Effects of Deactivation
Immediate Disconnect
Active sessions from this device are terminated.
Access Blocked
Device cannot establish new connections.
Slot Available
Device slot freed for new activation.
History Kept
Device records retained for audit purposes.
Related Endpoints
Permanent Action
Device deactivation removes the device from the user's account. The device can be reactivated later, but will require re-registration through the Reseller Activate Device API.
Need Device Information?
Use the Devices query to find device IDs and details for any user under your management.