rewards.v1.RewardCampaignService
AcknowledgeMyRewardAward
Acknowledge revealing an award or seeing its delivery for the authenticated root account. At least one mark is required. Marks are independent, permanent and idempotent; timestamps are assigned at first acknowledgement. Awards owned by another account return not_found.
Request
curl --request POST \ \
--url 'https://api.testnet.polyester.com/rewards.v1.RewardCampaignService/AcknowledgeMyRewardAward' \
--header 'Content-Type: application/json' \
--header 'Connect-Protocol-Version: 1' \
--data '{
"awardId": "7d32e3e0-5bcb-4a09-9184-cd4c8e95bc91",
"deliverySeen": true,
"revealed": true
}'Responses
{
"award": {
"amountBaseUnits": "123.45",
"assetId": 100,
"awardId": "value",
"campaignId": "value",
"campaignName": "value",
"deliverySeenAt": "2025-01-01T00:00:00Z",
"destinationAddress": "0x3333333333333333333333333333333333333333",
"fulfillmentMethod": "EXTERNAL_TESTNET",
"fulfillmentRevision": "1",
"fulfillmentState": "AWAITING_DESTINATION",
"network": "value",
"publishedAt": "2025-01-01T00:00:00Z",
"revealedAt": "2025-01-01T00:00:00Z",
"transactionId": "value"
}
}rewards.v1.AcknowledgeMyRewardAwardRequestrewards.v1.AcknowledgeMyRewardAwardResponseAward owned by the authenticated root account. Must be a UUID.
Record that the recipient revealed this award. False leaves the existing mark unchanged.
Record that the recipient saw this award's delivery. Requires a paid award; otherwise the entire request fails with failed_precondition. False leaves the existing mark unchanged.
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.
Time the recipient first acknowledged revealing this award. Absent until explicitly acknowledged; shared across sessions and devices.
Time the recipient first acknowledged seeing delivery of this paid award. Absent until explicitly acknowledged; independent of revealed_at.
| 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. |