Appearance
Delete a prize
DELETE
/programs/{id}/prizes/{prizeId}
Removes one option from the ladder. Prizes already redeemed are unaffected: a redemption is a transaction, and deleting the prize it named does not rewrite history.
Authorizations
ApiKeyBearer
A shop-scoped API key created in the dashboard and shown exactly once. An MCP tmk_ key presented here returns a 401 that names the mistake.
Type
HTTP (bearer)
Parameters
Header Parameters
Idempotency-Key
Makes a retry safe: a repeat with the same key and body replays the stored response; the same key with a different body is a 409. Keys are remembered for 24h (IDEMPOTENCY_DEDUPE_WINDOW_HOURS). A request without the header is processed normally.
Type
string
Max Length
255Path Parameters
id*
An opaque id. The API never promises an id format.
Type
Requiredstring
prizeId*
An opaque id. The API never promises an id format.
Type
Requiredstring
Responses
Done. No content.
DELETE
/programs/{id}/prizes/{prizeId}