---
title: "Delete billable events"
method: DELETE
path: "/v1/events"
tags: ["Billable events"]
---

# Delete billable events

`DELETE /v1/events`

Delete existing billable events.

## Request body

- union
  - object
    - `matching` 'record_ids', required
    - `record_ids` string[], required — List of event record IDs to delete.
  - object
    - `matching` 'customer_id', required
    - `customer_id` string, required — Customer ID for which the events will be deleted.
    - `event_type` string — Type corresponding to the event. When creating a dynamic product, this type will be used to map the related events to specific prices.
  - object
    - `matching` 'event_type', required
    - `event_type` string, required — When matching by `event_type`, every event of this type will be deleted across all customers.
  - object
    - `matching` 'all', required — All events will be deleted.

## Response `200`

Events deleted

- number — Number of events deleted

---

[API](https://skmtc.dev/hyperline/apis/hyperline-api.md) · [All operations](https://skmtc.dev/hyperline/apis/hyperline-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/hyperline/hyperline-api/revisions/19fa5f22e39b/schema)