Cancel a redemption (refund the points)
Resolves the redemption as CANCELED on Twitch - the viewer’s channel points are refunded. Call this when your automation couldn’t complete the redeemed action. Requires channel_points:manage and a TipPage-managed reward. Idempotent: repeating the call returns already_resolved: true.
/channel-points/redemptions/{redemptionId}/cancelAuthorizationBearer token (tp_live_... or tpat_...) · headerrequiredA TipPage API key (tp_live_..., created in Dashboard → Settings → Developer) or an OAuth 2.0 access token (tpat_..., see the OAuth guide). Both carry the same scopes and are accepted on every endpoint.
redemptionIdstringrequiredThe Twitch redemption id (UUID) - data.redemption_id on the twitch.channel_point_redemption webhook.
The redemption was resolved (or already was).
successbooleanstatusstringfulfilledcanceledalready_resolvedbooleanThis redemption had already been resolved to this status.
Missing or invalid credential (missing_api_key / invalid_api_key, or invalid_token for an expired/revoked OAuth access token).
errorstringrequiredHuman-readable message.
codestringMachine-readable code (e.g. missing_scope, not_in_queue).
The key lacks the required scope (missing_scope).
errorstringrequiredHuman-readable message.
codestringMachine-readable code (e.g. missing_scope, not_in_queue).
required_scopestringUnknown redemption id for this channel.
Not resolvable - code says why: reward_not_managed, already_resolved, song_request_active, or twitch_rejected.
Rate limit exceeded - check the RateLimit-* headers.
errorstringTwitch was unreachable or errored - retry shortly.