---
title: "Delete catalog snapshot diff."
method: DELETE
path: "/v1/catalog/diffs/{diff_id}"
tags: ["Catalog"]
---

# Delete catalog snapshot diff.

`DELETE /v1/catalog/diffs/{diff_id}`

## Request

- Base URL: `https://api.tlmtr.io`
- URL: `https://api.tlmtr.io/v1/catalog/diffs/{diff_id}`
- Auth: API key in header `x-api-key`
- TypeScript: <https://skmtc.dev/tlmtr/apis/telemetr-io-public-api/docs/v1/catalog/diffs/:diff_id/delete.ts> (a function with typed inputs; its response is checked against the schema)

Free for Credits keys; no credits or request quota are consumed.
An active key and snapshot access are still required.

Delete a diff and its stored change lists. The original snapshot is retained.
The response indicates whether the diff was deleted.
Catalog and snapshot access must both be enabled.

## Path parameters

- `diff_id` string, required

## Response `200`

- DeleteCatalogSnapshotDiffResponse
  - `diff_deleted` boolean, required: Whether this request deleted the diff.

## Other responses

- `403`: Catalog and snapshot access must both be enabled.
- `410`: Resource has expired.
- `429`: Request rate limit reached. Honor Retry-After.
- `503`: Snapshot storage is temporarily unavailable.

## Changes

- **2026-09-24** `2f9bd490eb3c`: 1 info
  - removed the non-success response with the status `402`
- **2026-09-10** `80951ad7b3fb`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/tlmtr/apis/telemetr-io-public-api/changes/v1/catalog/diffs/:diff_id/delete.md)

---

[API](https://skmtc.dev/tlmtr/apis/telemetr-io-public-api.md) - [All operations](https://skmtc.dev/tlmtr/apis/telemetr-io-public-api/llms.txt) - [OpenAPI document](https://skmtc.dev/tlmtr/apis/telemetr-io-public-api/revisions/98f399867856?raw)