---
title: "Destroy a secret before it is opened"
method: DELETE
path: "/OneTimeSecrets/{id}"
tags: ["Onetimesecrets"]
---

# Destroy a secret before it is opened

`DELETE /OneTimeSecrets/{id}`

**Requires permission:** *IT*

Drops the ciphertext. The row stays so anybody who follows the link is told it was withdrawn rather than meeting a dead page.

## Path parameters

- `id` integer, required

## Response `200`

Success

- DeleteOneTimeSecretResponse
  - `revoked` boolean

## Other responses

- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not found

## Changes

- **2026-08-15** `5aa4178ca29b` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/tonbridge/apis/tonbridge-app-api/changes/OneTimeSecrets/:id/delete.md)

---

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