---
title: "Delete catalog snapshot."
method: DELETE
path: "/v1/catalog/snapshots/{snapshot_id}"
tags: ["Catalog"]
---

# Delete catalog snapshot.

`DELETE /v1/catalog/snapshots/{snapshot_id}`

## Request

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

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

Delete a snapshot owned by your user. Set `cascade=true` to also delete its
stored diffs and their change lists. By default, existing diffs are retained
and remain readable until they expire; new diffs require an active snapshot.
The response indicates whether a snapshot was deleted and how many diffs were deleted.
Concurrent mutations may return 429; retry after `Retry-After`.
Catalog and snapshot access must both be enabled.

## Path parameters

- `snapshot_id` string, required

## Query parameters

- `cascade` boolean

## Response `200`

- DeleteCatalogSnapshotResponse
  - `snapshot_deleted` boolean, required: Whether this request deleted the snapshot.
  - `diffs_deleted` integer, required: Number of diffs deleted together with the snapshot. Zero when cascade is false.

## Other responses

- `403`: Catalog and snapshot access must both be enabled.
- `410`: Resource has expired.
- `429`: Active resource limit reached or a conflicting operation is in progress. Inspect code; honor Retry-After for temporary conflicts.
- `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/snapshots/:snapshot_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)