Update Reseller Score Limits API
Bulk update maximum score limits for multiple scoring symbols in a single API call
Update Score Limits API
Update multiple score limits in a single request. Efficiently configure maximum contributions for all scoring categories across your reseller program.
Bulk Updates
Update multiple score limits in one API call.
Efficient
Single request for comprehensive limit changes.
Atomic Operation
All limits updated together or none at all.
Endpoint Overview
/graphqlUpdate maximum score limits for multiple scoring symbols at once. Accepts an array of symbol-limit pairs for bulk configuration.
Request Parameters
resellerScoreLimitEdits[ResellerScoreLimitEdit]!RequiredArray of score limit updates. Each item contains a symbol and its new maximum limit.
symbolString!RequiredThe symbol identifier for the score category.
maxLimitInt!RequiredThe new maximum score limit for this symbol.
GraphQL Mutation
mutation updateResellerScoreLimits(
$resellerScoreLimitEdits: [ResellerScoreLimitEdit]
) {
updateResellerScoreLimits(
resellerScoreLimitEdits: $resellerScoreLimitEdits
) {
scoreDefinition
symbol
maximumLimit
}
}Variables:
{
"resellerScoreLimitEdits": [
{ "symbol": "CREDIT", "maxLimit": 3000 },
{ "symbol": "SALES", "maxLimit": 5000 },
{ "symbol": "SUBS", "maxLimit": 2500 },
{ "symbol": "DURATION", "maxLimit": 1500 }
]
}HTTP Request:
curl -X POST https://api.orbnet.com/graphql \
-H "Content-Type: application/json" \
-H "Authorization: Bearer YOUR_ADMIN_TOKEN" \
-d '{
"query": "mutation updateResellerScoreLimits($resellerScoreLimitEdits: [ResellerScoreLimitEdit]) { updateResellerScoreLimits(resellerScoreLimitEdits: $resellerScoreLimitEdits) { scoreDefinition symbol maximumLimit } }",
"variables": {
"resellerScoreLimitEdits": [
{ "symbol": "CREDIT", "maxLimit": 3000 },
{ "symbol": "SALES", "maxLimit": 5000 },
{ "symbol": "SUBS", "maxLimit": 2500 },
{ "symbol": "DURATION", "maxLimit": 1500 }
]
}
}'Response
{
"data": {
"updateResellerScoreLimits": [
{
"scoreDefinition": "Credit usage contributions",
"symbol": "CREDIT",
"maximumLimit": "3000"
},
{
"scoreDefinition": "Sales volume contributions",
"symbol": "SALES",
"maximumLimit": "5000"
},
{
"scoreDefinition": "Subscription count contributions",
"symbol": "SUBS",
"maximumLimit": "2500"
},
{
"scoreDefinition": "Membership duration contributions",
"symbol": "DURATION",
"maximumLimit": "1500"
}
]
}
}{
"errors": [
{
"message": "Unknown score symbol: INVALID",
"path": ["updateResellerScoreLimits"],
"extensions": {
"code": "INVALID_SYMBOL",
"invalidSymbol": "INVALID"
}
}
],
"data": null
}Example Score Limit Configuration
CREDIT: 3,000
Max contribution from credit-related metrics (25% of theoretical max).
SALES: 5,000
Max contribution from sales metrics (42% of theoretical max).
SUBS: 2,500
Max contribution from subscription count (21% of theoretical max).
DURATION: 1,500
Max contribution from membership duration (12% of theoretical max).
Best Practices
Plan Total Score
Sum of all limits determines max possible score. Plan limits accordingly.
Align with Levels
Ensure total possible score exceeds highest level threshold.
Reward Diversity
Spread limits to reward resellers who perform well across multiple metrics.
Recalculate Scores
After updating limits, recalculate affected reseller scores.
Related Endpoints
Score Impact
Changing score limits affects all reseller scores. Some resellers may change levels after limit updates. Consider communicating changes to your reseller network.
Verify Your Changes
After updating score limits, use the Calculate Score API to verify how changes affect individual reseller scores.