---
title: "Bulk-clear the delivery log"
method: DELETE
path: "/v1/delivery/items"
tags: ["Delivery"]
---

# Bulk-clear the delivery log

`DELETE /v1/delivery/items`

## Request

- Base URL: `https://api.talonic.com`
- URL: `https://api.talonic.com/v1/delivery/items`
- Auth: HTTP bearer

Deletes every delivery attempt record for the tenant matching the
optional `binding_id` / `destination_id` / `status` filters, the
same filters as the list route (no filters clears the whole log).
This is a deliberate admin cleanup: dead-letter rows referencing a
deleted item are de-linked, not removed. Requires an
organization-scoped API key.

Rows are removed in bounded batches for a fixed time budget per
request; a large log answers `remaining: true` with the count removed
so far, and the caller repeats the same request until it answers
`remaining: false`.

## Query parameters

- `binding_id` string, uuid
- `destination_id` string, uuid
- `status` 'in_flight' | 'succeeded' | 'failed' | 'superseded'

## Response `200`

Rows removed in this request.

- object
  - `deleted` integer
  - `remaining` boolean: True when the time budget ended before the matching set was exhausted; call again.

## Other responses

- `400`: The request is invalid.
- `401`: Missing or invalid API key.
- `429`: Daily rate limit exceeded.

---

[API](https://skmtc.dev/talonic/apis/talonic-api.md) · [All operations](https://skmtc.dev/talonic/apis/talonic-api/llms.txt) · [OpenAPI document](https://skmtc.dev/talonic/apis/talonic-api/revisions/678fe5f8c9c3?raw)