Update Reseller Score Limit by Symbol API
Update the maximum score limit for a specific scoring symbol or metric category
Update Score Limit by Symbol API
Configure maximum score limits for individual scoring symbols. Control how much each metric category can contribute to a reseller's total score.
Single Symbol
Update one score limit at a time for precise control.
Cap Contributions
Prevent any single metric from dominating scores.
Fine Tuning
Adjust individual limits without affecting others.
Endpoint Overview
/graphqlUpdate the maximum score limit for a specific scoring symbol. Limits cap how much a single metric can contribute to the total reseller score.
Request Parameters
symbolString!RequiredThe symbol identifier for the score category to update (e.g., "CREDIT", "SALES", "SUBS").
maxLimitInt!RequiredThe new maximum score limit for this symbol.
Available Symbols
CREDIT
Credit-related score contributions (monthly and current balance).
SALES
Sales volume score contributions (total and monthly).
SUBS
Active subscription count score contributions.
DURATION
Membership duration score contributions.
GraphQL Mutation
mutation updateResellerScoreLimitBySymbol(
$resellerScoreLimitEdit: ResellerScoreLimitEdit
) {
updateResellerScoreLimitBySymbol(
resellerScoreLimitEdit: $resellerScoreLimitEdit
) {
scoreDefinition
symbol
maximumLimit
}
}Variables:
{
"resellerScoreLimitEdit": {
"symbol": "SALES",
"maxLimit": 5000
}
}HTTP Request:
curl -X POST https://api.orbnet.com/graphql \
-H "Content-Type: application/json" \
-H "Authorization: Bearer YOUR_ADMIN_TOKEN" \
-d '{
"query": "mutation updateResellerScoreLimitBySymbol($resellerScoreLimitEdit: ResellerScoreLimitEdit) { updateResellerScoreLimitBySymbol(resellerScoreLimitEdit: $resellerScoreLimitEdit) { scoreDefinition symbol maximumLimit } }",
"variables": {
"resellerScoreLimitEdit": {
"symbol": "SALES",
"maxLimit": 5000
}
}
}'Response
{
"data": {
"updateResellerScoreLimitBySymbol": {
"scoreDefinition": "Total and monthly sales contribution",
"symbol": "SALES",
"maximumLimit": "5000"
}
}
}{
"errors": [
{
"message": "Unknown score symbol",
"path": ["updateResellerScoreLimitBySymbol"],
"extensions": {
"code": "INVALID_SYMBOL"
}
}
],
"data": null
}Best Practices
Balance Limits
Set limits that allow diverse paths to high scores, not just one dominant metric.
Test Impact
Calculate sample scores before and after changes to understand impact.
Document Changes
Keep records of limit changes and reasons for auditing purposes.
Gradual Adjustments
Make incremental changes rather than drastic limit modifications.
Related Endpoints
Bulk Updates
If you need to update multiple score limits at once, use the Update Score Limits API which accepts an array of limit changes in a single request.
Update Multiple Limits
Need to update several score limits at once? Use the bulk update endpoint for efficiency.