---
title: "/:channel/:giveawayId"
method: DELETE
path: "/giveaways/{channel}/{giveawayId}"
tags: ["single giveaway"]
---

# /:channel/:giveawayId

`DELETE /giveaways/{channel}/{giveawayId}`

## Request

- Base URL: `https://api.streamelements.com/kappa/v2`
- URL: `https://api.streamelements.com/kappa/v2/giveaways/{channel}/{giveawayId}`
- Auth: one of:
  - HTTP bearer
  - OAuth 2
    - Authorization code: `https://api.streamelements.com/oauth2/authorize`
    - Token URL: `https://api.streamelements.com/oauth2/token`
  - HTTP bearer
- TypeScript: <https://skmtc.dev/streamelements/apis/se-api-docs/docs/giveaways/:channel/:giveawayId/delete.ts> (a function with typed inputs; its response is checked against the schema)

Delete Giveaway This endpoint is available only in the API version 3. Make sure to use the v3 base URL: https://api.streamelements.com/kappa/v3.

## Path parameters

- `channel` string, required
- `giveawayId` string, required

## Headers

- `Accept` string, required

## Response `200`

## Other responses

- `400`: Bad Request

## Changes

- **2022-08-19** `7ec3cd3b664e`: 1 breaking, 3 info
  - the response's body type changed from no type to `object` for status `400`
  - added the required property `error` to the response with the `400` status
  - added the required property `message` to the response with the `400` status
  - added the required property `statusCode` to the response with the `400` status
- **2021-02-07** `6f0746f170b0`: 1 warning
  - deleted the `header` request parameter `Content-Type`

[Operation history](https://skmtc.dev/streamelements/apis/se-api-docs/changes/giveaways/:channel/:giveawayId/delete.md)

---

[API](https://skmtc.dev/streamelements/apis/se-api-docs.md) - [All operations](https://skmtc.dev/streamelements/apis/se-api-docs/llms.txt) - [OpenAPI document](https://skmtc.dev/streamelements/apis/se-api-docs/revisions/aa13169b9373?raw)
