---
title: "Delete an event"
method: DELETE
path: "/v1/events/{idempotencyKey}"
tags: ["Events"]
---

# Delete an event

`DELETE /v1/events/{idempotencyKey}`

Deletes a usage event by creating a new deletion event that links back to the original event. Requires valid authentication. Reach out to your account manager if you would like to participate in the Beta for the new Usage API.

## Path parameters

- `idempotencyKey` string, uuid, required

## Response `200`

Event deleted successfully

- EventDeleteResponse — Response for successful event deletion
  - `success` boolean — Indicates if the operation was successful
  - `message` string — Human-readable message about the operation result
  - `data` EventData — Event data wrapper
    - `events` EventResponse — Event response data
      - `customerId` string, uuid — Tabs Customer ID - must be a valid UUID v4
      - `eventTypeId` string, uuid — Type of event being recorded - must be a valid UUID v4
      - `datetime` string, date-time — Timestamp when the event occurred (UTC) (format: ISO-8601 datetime string)
      - `idempotencyKey` string, uuid — Unique key to prevent duplicate event processing - must be a valid UUID v4
      - `value` number, double — Numeric value of the event
      - `differentiator` string — Optional key to separate events with the same event type and customer into different invoice line items; differentiator will be appended to the description of the new invoice line item
      - `invoiceSplitKey` string — Optional key to split events into a new invoice; the split key will be appended to the new invoice number
      - `parentEventId` string, uuid — Parent event ID - the idempotency key of the original event that was deleted (only present in DELETE responses)
      - `metadata` object — Optional metadata in JSON format

## Other responses

- `400` — Bad request - Event not found or invalid idempotency key
- `401` — Unauthorized - Invalid or missing API key
- `429` — Too Many Requests - Rate limit exceeded
- `500` — Internal Server Error

---

[API](https://skmtc.net/tabsplatform/apis/tabs-external-api.md) · [All operations](https://skmtc.net/tabsplatform/apis/tabs-external-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/tabsplatform/tabs-external-api/revisions/7e8885517814/schema)