rewards.v1.RewardCampaignService
SetMyRewardDestination
Record a write-once external payout destination for an award owned by the authenticated root account.
Request
curl --request POST \ \
--url 'https://api.testnet.polyester.com/rewards.v1.RewardCampaignService/SetMyRewardDestination' \
--header 'Content-Type: application/json' \
--header 'Connect-Protocol-Version: 1' \
--data '{
"awardId": "example",
"destinationAddress": "0x3333333333333333333333333333333333333333",
"expectedRevision": "1",
"requestId": "request_01J0EXAMPLE"
}'Responses
{
"award": {
"amountBaseUnits": "123.45",
"assetId": 100,
"awardId": "value",
"campaignId": "value",
"campaignName": "value",
"destinationAddress": "0x3333333333333333333333333333333333333333",
"fulfillmentMethod": "EXTERNAL_TESTNET",
"fulfillmentRevision": "1",
"fulfillmentState": "AWAITING_DESTINATION",
"network": "value",
"publishedAt": "2025-01-01T00:00:00Z",
"transactionId": "value"
}
}rewards.v1.SetMyRewardDestinationRequestrewards.v1.SetMyRewardDestinationResponseAward owned by the authenticated root account.
Destination address interpreted according to the award campaign's network.
Fulfillment revision observed by the recipient.
Client-generated idempotency identifier. Maximum 128 characters.
Stable opaque award identifier.
Stable campaign identifier.
Campaign display name frozen at publication.
Canonical asset identifier.
Exact integer amount in the asset's smallest base unit.
Selected delivery method.
Current delivery state.
Publication time.
Campaign payout network. Interpret destination_address in this network.
Current fulfillment revision for optimistic concurrency.
Recipient payout destination once submitted. Empty until provided.
External transaction identifier once staff records delivery. Empty until delivered.
| Key | HTTP status | Connect code | Error | When |
|---|---|---|---|---|
| unauthenticated | 401 | unauthenticated | Unauthenticated | Authentication required. |
| permission-denied | 403 | permission_denied | Permission Denied | Permission denied. |
| invalid-argument | 400 | invalid_argument | Invalid Argument | Invalid argument. |
| not-found | 404 | not_found | Not Found | Not found. |
| unavailable | 503 | unavailable | Unavailable | Service unavailable. |