---
title: "Changes to Delete a capsule. It moves to Recently deleted and can be recovered for 30 days; ?permanent=true deletes it for good now (also for a capsule already in Recently deleted). A capsule that owns a log answers 409 `owned_log_present` naming the log and its entry count until `confirmOwnedLog=true` is sent; the log is then deleted with it, or detached and kept when you may not delete it. A log you may not read is never named: it is detached and kept, with no 409. A capsule other capsules cite needs ?confirm_citations=true; sending confirm_citations=true or confirm_citations=false opts in to that gate before its breaking-change effective date."
method: DELETE
path: "/api/preview/capsules/{id}"
---

# Changes to Delete a capsule. It moves to Recently deleted and can be recovered for 30 days; ?permanent=true deletes it for good now (also for a capsule already in Recently deleted). A capsule that owns a log answers 409 `owned_log_present` naming the log and its entry count until `confirmOwnedLog=true` is sent; the log is then deleted with it, or detached and kept when you may not delete it. A log you may not read is never named: it is detached and kept, with no 409. A capsule other capsules cite needs ?confirm_citations=true; sending confirm_citations=true or confirm_citations=false opts in to that gate before its breaking-change effective date.

`DELETE /api/preview/capsules/{id}`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 2 of 12 revisions.

- **2026-10-19** `5778844d1f9e`: 2 info
- **2026-10-09** `c7729725d527`: 3 info

## Changes

- **2026-10-19** `5778844d1f9e`: 2 info
  - added the new optional `query` request parameter `permanent`
  - added the optional property `recoverableUntil` to the response with the `200` status
- **2026-10-09** `c7729725d527`: 3 info
  - added the new optional `query` request parameter `confirmOwnedLog`
  - added the new optional `query` request parameter `confirm_citations`
  - added the optional property `ownedLog` to the response with the `200` status

---

[Operation](https://skmtc.dev/symbol/apis/symbol-api/docs/api/preview/capsules/:id/delete.md) - [API](https://skmtc.dev/symbol/apis/symbol-api.md) - [Page](https://skmtc.dev/symbol/apis/symbol-api/changes/api/preview/capsules/:id/delete)
