Update Reseller Level API
Update reseller tier levels including discount percentages and minimum score requirements
Update Reseller Level API
Manage reseller tier levels and their associated benefits. Update discount percentages and minimum score thresholds for each reseller level in your partner program.
Tier Management
Define multiple reseller levels with unique benefits.
Discount Control
Set discount percentages for each tier level.
Score Thresholds
Configure minimum scores required for each level.
Endpoint Overview
/graphqlUpdate a reseller level's configuration including the discount percentage and minimum score required to achieve that level.
Request Parameters
idInt!RequiredThe unique identifier of the reseller level to update.
levelResellerLevelEdit!RequiredObject containing the level configuration to update.
discountPercentFloatThe discount percentage granted to resellers at this level (0-100).
minScoreIntThe minimum score required for a reseller to achieve this level.
GraphQL Mutation
mutation updateResellerLevel($id: Int!, $level: ResellerLevelEdit!) {
updateResellerLevel(id: $id, level: $level) {
id
name
discountPercent
minScore
}
}Variables:
{
"id": 2,
"level": {
"discountPercent": 15.0,
"minScore": 1000
}
}HTTP Request:
curl -X POST https://api.orbnet.com/graphql \
-H "Content-Type: application/json" \
-H "Authorization: Bearer YOUR_ADMIN_TOKEN" \
-d '{
"query": "mutation updateResellerLevel($id: Int!, $level: ResellerLevelEdit!) { updateResellerLevel(id: $id, level: $level) { id name discountPercent minScore } }",
"variables": {
"id": 2,
"level": {
"discountPercent": 15.0,
"minScore": 1000
}
}
}'Response
{
"data": {
"updateResellerLevel": {
"id": "2",
"name": "Silver",
"discountPercent": 15.0,
"minScore": 1000
}
}
}{
"errors": [
{
"message": "Reseller level not found",
"path": ["updateResellerLevel"],
"extensions": {
"code": "LEVEL_NOT_FOUND"
}
}
],
"data": null
}{
"errors": [
{
"message": "Admin access required",
"path": ["updateResellerLevel"],
"extensions": {
"code": "FORBIDDEN"
}
}
],
"data": null
}Reseller Level Example Structure
Bronze (Level 1)
Entry level: 0 min score, 5% discount
Silver (Level 2)
Mid tier: 1000 min score, 15% discount
Gold (Level 3)
High tier: 5000 min score, 25% discount
Platinum (Level 4)
Top tier: 10000 min score, 35% discount
Best Practices
Progressive Tiers
Set increasing discounts and scores to incentivize reseller growth.
Reasonable Thresholds
Ensure score thresholds are achievable to motivate resellers.
Communicate Changes
Notify resellers when level requirements or benefits change.
Monitor Impact
Track how level changes affect reseller behavior and revenue.
Related Endpoints
Admin Access Required
This endpoint requires admin-level permissions. Only users with administrative access can modify reseller level configurations.
Configure Scoring System
Customize how reseller scores are calculated by updating the level coefficients and score limits.