Skip to content
TipPage Docs
Esc
↑↓navigate↵open⌘Jpreview

Delete a reward

Deletes a TipPage-created reward from the Twitch channel. Rewards with TipPage actions set up on the dashboard (has_actions) are removed there instead.

DELETE/channel-points/rewards/{rewardId}
Authorization
AuthorizationBearer token (tp_live_... or tpat_...) · headerrequired

A 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.

Path parameters
rewardIdstringrequired

The reward's id.

Responses
200

Deleted.

successboolean
401

Missing or invalid credential (missing_api_key / invalid_api_key, or invalid_token for an expired/revoked OAuth access token).

errorstringrequired

Human-readable message.

codestring

Machine-readable code (e.g. missing_scope, not_in_queue).

403

The key lacks the required scope (missing_scope).

errorstringrequired

Human-readable message.

codestring

Machine-readable code (e.g. missing_scope, not_in_queue).

required_scopestring
404

No such resource.

errorstringrequired

Human-readable message.

codestring

Machine-readable code (e.g. missing_scope, not_in_queue).

409

The reward has dashboard actions (reward_has_actions), or Twitch needs reconnecting (twitch_reauth).

errorstringrequired

Human-readable message.

codestring

Machine-readable code (e.g. missing_scope, not_in_queue).

429

Rate limit exceeded - check the RateLimit-* headers.

errorstring
502

Twitch was unreachable or errored - retry shortly.

Try it
Server
Authorization
Parameters
Request
curl -X DELETE 'https://api.tippage.com/v1/channel-points/rewards/cpr_0123456789abcdef' \
  -H 'Authorization: Bearer YOUR_TOKEN' \
  -H 'Accept: application/json'
Response
{
  "success": true
}