Update rebate group
PATCH/v1/partnership/autorebates/groups/:group_id
Update a group's name, rebate percentage, rebate period, default status, or partner link. Always include the intended rebate_percent, even when changing another setting. For WEEKLY or MONTHLY, send rebate_period_value with rebate_period: 1–7 for a weekday or 1–31 for a day of the month. A partner link code must belong to you and cannot be used by another group. Setting a positive percentage, making the group default, or changing its period switches it to MANUAL. Some changes need separate approval; check need_approve in the response. You cannot switch a group to AUTO or change an archived group with this operation.
Required scopes:
- write:
partnership.all.
Rate limits:
- This operation counts toward the shared limit of 600 requests per 60 seconds per partner, across all of the partner's API keys and all Partnership API operations.
Consistency and recovery notes:
- This API does not guarantee idempotent writes. If the response is lost, read the affected group, rule, client settings, or rebate rows before deciding whether to send the write again.
Possible errors:
ThrottledServiceTransportErrorErrorAuthenticationFailedPermissionDeniedValidationErrorNotFound
Request
Responses
- 200
- 400
- 401
- 403
- 404
- 429
- 500
- 502
- 503
- 504
Updated group and approval requirement.
Bad request or validation error. The response uses either the numeric request-processing error response or the Partnership string-code error response.
Authentication failed. Authentication processing errors use numeric codes; a Partnership operation authentication error uses a string code.
Operation is not permitted for the authenticated API key, partner, or operation scope.
Requested resource was not found or is not visible to the authenticated partner.
Rate limit exceeded.
Response Headers
Seconds to wait before retrying when the API provides a throttle wait time.
The API or a service required by the operation could not complete the request.
The API could not complete the request to the Partnership service.
A required service is temporarily unavailable or the request deadline was exceeded.
A service required by the Partnership operation could not be reached or timed out.