---
title: Delete Events
slug: jetstream-v2/delete-events
docTags: 
createdAt: 2024-01-23T15:42:08.869Z
---

## About

Remove event messages from the events queue of the Jetstream user whose access key is being used. Events are removed in batches using the batch ID. Events are removed individually or as a collection using event IDs.

## Parameters

| **Property**                                                        | **Location** | **Details**                                                                                                                                                                                                                                                                                                                                                                                                         |
| ------------------------------------------------------------------- | ------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **AccessKey**<br />:::BlockQuote
string&#xA;Required&#xA;Unique
::: | Header       | The access key for your user account.<br />This value is a 36-character GUID provided during [user account sign up](https://jetstreamrfid.com/login/signup).                                                                                                                                                                                                                                                        |
| **BatchId**<br />:::BlockQuote
string&#xA;Unique
:::                | Body         | The batch ID associated with the batch of event messages to be removed.<br />This value is a 36-character GUID provided via a [Get Events](docId:-yAQw97IR03LGkHNuI2mb) request.<br />Each [Get Events](docId:-yAQw97IR03LGkHNuI2mb) request returns a batch of event messages along with an associated batch ID. By using this batch ID with a Delete Events request, all events within this batch can be removed. |
| **EventIds**<br />:::BlockQuote
array(string)&#xA;Unique
:::        | Body         | The set of event IDs associated with the individual event message or collection of event messages to be removed.<br />Each value is a 36-character GUID associated with an event message.<br />More than 100 event IDs may not be defined, despite the fact that more than 100 events may be returned via a [Get Events](docId:-yAQw97IR03LGkHNuI2mb) request.                                                      |

**More Info**

Delete Events requires that either the BatchId property or the EventId property be defined with each request. You may not pass both at the same time. If you need to remove individual events and a batch of events, you must make two separate requests.

## Examples

### Example Delete by BatchId

**Request URL**

**DELETE** https\://api.jetstreamrfid.com/2/events

**Request Body**

:::BlockQuote
\{
&#x20;   "BatchId": "c15d316b-5fc3-4a7f-a2ba-b1a96aabcd32"
}
:::

**Response Code**

204 No Content

**Response Body**

None Returned

### Example Delete by EventIds

**Request URL**

**DELETE** https\://api.jetstreamrfid.com/2/events

**Request Body**

:::BlockQuote
\{
&#x20;   "EventIds": \[
&#x20;       "8af92758-451c-4082-a455-d57e927676a8",
&#x20;       "64f295f7-ceb6-46aa-a5d0-2a66e7009ff0"
&#x20;   ]
}
:::

**Response Code**

204 No Content

**Response Body**

None Returned

## Version Changes

Replaces RemoveEvents