Set Reseller Level API
Update reseller tier levels to adjust permissions, credit limits, and access
Set Reseller Level API
Update a reseller's tier level to adjust their permissions, credit limits, and platform access. Levels determine what features and capabilities resellers have.
Tier Assignment
Assign appropriate tier levels.
Upgrade Path
Promote high-performing resellers.
Permission Control
Adjust access based on level.
Endpoint Overview
/graphqlSet or update the level/tier of an existing reseller. The level determines permissions, credit limits, and feature access.
Request Parameters
resellerIdInt!RequiredThe unique identifier of the reseller whose level is being updated.
levelResellerLevelName!RequiredThe new level/tier to assign to the reseller (e.g., BRONZE, SILVER, GOLD, PLATINUM).
GraphQL Mutation
mutation setResellerLevel($resellerId: Int!, $level: ResellerLevelName!) {
setResellerLevel(resellerId: $resellerId, level: $level) {
id
email
firstName
lastName
credit
level
phone
}
}Variables:
{
"resellerId": 12345,
"level": "GOLD"
}HTTP Request:
curl -X POST https://api.orbnet.com/graphql \
-H "Content-Type: application/json" \
-H "Authorization: Bearer YOUR_ADMIN_TOKEN" \
-d '{
"query": "mutation setResellerLevel($resellerId: Int!, $level: ResellerLevelName!) { setResellerLevel(resellerId: $resellerId, level: $level) { id email level } }",
"variables": {
"resellerId": 12345,
"level": "GOLD"
}
}'Response
{
"data": {
"setResellerLevel": {
"id": "12345",
"email": "partner@company.com",
"firstName": "John",
"lastName": "Partner",
"credit": "1500",
"level": "GOLD",
"phone": "+1234567890"
}
}
}{
"errors": [
{
"message": "Invalid reseller level: DIAMOND",
"path": ["setResellerLevel"],
"extensions": {
"code": "INVALID_LEVEL"
}
}
],
"data": null
}Available Levels
Bronze
Entry level: Basic features, lower credit limits, standard commission rates.
Silver
Mid-tier: Extended features, moderate limits, improved commissions.
Gold
Premium: Full features, high limits, priority support, better rates.
Platinum
Elite: All features, highest limits, dedicated support, best commissions.
Level Benefits
Credit Limits
Commission Rates
Feature Access
Support Priority
Best Practices
Performance-Based
Promote based on reseller performance metrics.
Clear Criteria
Define level requirements transparently.
Review Periodically
Regularly assess reseller levels.
Notify Changes
Inform resellers of level changes.
Related Endpoints
Immediate Effect
Level changes take effect immediately. The reseller's permissions and limits will update on their next API call or login.
Configure Level Benefits
Customize what each level offers by updating the level coefficients and limits.