Api

Retry Reward Delivery

POST
/v1/rewards/{rewardId}/delivery/retry

Make a failed RefRef delivery of a Reward due again. A write applies at once. Needs the rewards:fulfill key permission.

Authorization

WorkspaceApiKey
X-Api-Key<token>

Workspace-owned Better Auth API key of one environment (Sandbox or Live); it authorizes the Projects of that environment in its Workspace. A Project of the other environment returns 403 ENVIRONMENT_MISMATCH. Never expose it in the browser.

In: header

Path Parameters

rewardId*string
Match\S
Length1 <= length <= 512

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

curl -X POST "https://example.com/v1/rewards/string/delivery/retry" \  -H "Content-Type: application/json" \  -d '{    "projectId": "string"  }'
{  "success": true,  "data": {    "id": "string",    "createdAt": "string",    "updatedAt": "string",    "projectId": "string",    "evaluationId": "string",    "participantId": "string",    "programId": "string",    "ruleId": "string",    "termsVersionId": "string",    "allowanceId": "string",    "beneficiaryRole": "referrer",    "beneficiaryParticipantId": "string",    "benefitKind": "cash",    "amountMinor": "string",    "currency": "string",    "currencyExponent": -9007199254740991,    "typedBenefitSnapshot": {      "property1": null,      "property2": null    },    "purchaseId": "string",    "void": {      "id": "string",      "reasonCode": "fraud",      "reason": "string",      "actor": "string",      "voidedAt": "string"    },    "netAmountMinor": "string",    "fulfillmentStatus": "pending",    "fulfillment": {      "id": "string",      "externalReference": "string",      "occurredAt": "string",      "actor": "string"    },    "revocation": {      "id": "string",      "externalReference": "string",      "occurredAt": "string",      "actor": "string"    },    "delivery": {      "method": "operator",      "status": "pending",      "reason": "awaiting_operator",      "providerReference": "string",      "connectionId": "string",      "attemptCount": -9007199254740991,      "lastError": "string",      "nextAttemptAt": "string",      "grantDispatchedAt": "string",      "revocationDispatchedAt": "string",      "deliveredAmountMinor": "string",      "targetPlan": "string",      "planPeriods": -9007199254740991,      "revertDueAt": "string",      "revertedAt": "string",      "revertOutcome": "reverted"    }  }}