Reseller Logout Device API
Allow resellers to logout devices for users they manage
Reseller Logout Device API
Enable resellers to manage device sessions for their users. Log out devices without requiring admin access - perfect for reseller self-service portals.
Reseller Scoped
Only affects users under the reseller's management.
Secure Access
Resellers can only manage their own users.
Self-Service
No admin intervention required.
Endpoint Overview
/graphqlLog out a device for a user managed by the authenticated reseller. The reseller can only affect users assigned to them.
Request Parameters
userIdInt!RequiredThe unique identifier of the user (must be under reseller's management).
deviceIdInputDeviceIdInput!RequiredObject containing the device identification details.
GraphQL Mutation
mutation resellerLogoutDevice($userId: Int!, $deviceIdInput: DeviceIdInput!) {
resellerLogoutDevice(userId: $userId, deviceIdInput: $deviceIdInput)
}Variables:
{
"userId": 12345,
"deviceIdInput": {
"uuid": "550e8400-e29b-41d4-a716-446655440000",
"serial": "ABC123XYZ789",
"name": "Customer's iPhone"
}
}HTTP Request:
curl -X POST https://api.orbnet.com/graphql \
-H "Content-Type: application/json" \
-H "Authorization: Bearer YOUR_RESELLER_TOKEN" \
-d '{
"query": "mutation resellerLogoutDevice($userId: Int!, $deviceIdInput: DeviceIdInput!) { resellerLogoutDevice(userId: $userId, deviceIdInput: $deviceIdInput) }",
"variables": {
"userId": 12345,
"deviceIdInput": {
"uuid": "550e8400-e29b-41d4-a716-446655440000",
"serial": "ABC123XYZ789",
"name": "Customers iPhone"
}
}
}'Response
{
"data": {
"resellerLogoutDevice": true
}
}{
"errors": [
{
"message": "User is not under your management",
"path": ["resellerLogoutDevice"],
"extensions": {
"code": "FORBIDDEN"
}
}
],
"data": null
}{
"errors": [
{
"message": "Device not found or not active",
"path": ["resellerLogoutDevice"],
"extensions": {
"code": "DEVICE_NOT_FOUND"
}
}
],
"data": null
}Reseller Capabilities
User Support
Help users troubleshoot by logging out stuck sessions.
Security Management
Quickly respond to user security concerns.
Device Cleanup
Log out unused devices to free up slots.
Remote Assistance
Manage devices without direct user intervention.
Access Control
Can Access
Users created by or assigned to the reseller.
Cannot Access
Users under other resellers or admin-only users.
Related Endpoints
Reseller Scope
This endpoint automatically validates that the target user belongs to the authenticated reseller. Attempting to manage users outside your scope will result in a forbidden error.
Manage Your Users
View all users under your reseller account to find device information and user IDs.