vaults

Delete an ingot

Changed on Oct 28, 2026

Permanently delete an ingot: its content, every SparkLink for it, its audit trail, and an upload staged onto it, whose Forge URL and upload session Forge refuses from then on (410 UPLOAD_GONE) and whose reserved storage is released. With upload_id, the upload the ingot's create answered, the ingot is deleted only while it is still that upload's unfinished file: the upload is ended before anything else, and an ingot it published before the delete reached it, or that a later upload of it took over, is left whole (412). This is how a client that gives an upload up (its user cancelled it, or it failed for good) ends it with the file its create made, never a file the upload published.

delete/vaults/{id}/ingots/{ingot_id}

Request

Base URL
https://api.sparkvault.com/v1
Auth
- API key in header X-API-Key and API key in header X-Vault-Access-Token
- or HTTP bearer and API key in header X-Vault-Access-Token
TypeScript
https://skmtc.dev/sparkvault/apis/sparkvault-api/docs/vaults/:id/ingots/:ingot_id/delete.ts
A function with typed inputs. Its response is checked against the schema.

Path parameters

idstring required

The vault.

ingot_idstring required

The ingot's id, or : followed by its name in the vault.

Query parameters

upload_idstring

The upload_id the ingot's create answered. Deletes the ingot only while it is that upload's unfinished file.

Response

Deleted.

Changes

Oct 28, 2026a9a10e328ba5 Revision changes
- info
  the response property / became required for the status
- info
  the response property / became required for the status
- info
  the response property / became required for the status
- info
  the response property / became required for the status
- info
  the response property became required for the status
- info
  the response property became required for the status
- info
  the response property became required for the status
- info
  the response property became required for the status
- info
  the response property / became required for the status
- info
  the response property / became required for the status
- info
  the response property / became required for the status
- info
  the response property / became required for the status
- info
  added the required property / to the response with the status
- info
  added the required property / to the response with the status
- info
  added the required property / to the response with the status
- info
  added the required property / to the response with the status
Oct 28, 202656d7c265a77a Revision changes
- breaking
  the response property / became nullable for the status
- breaking
  the response property / became nullable for the status
- breaking
  the response property / became nullable for the status
- breaking
  the response property / became nullable for the status

Operation history (3 revisions)