Storage

Unpin a stored file from this account

Requires scope files:write. Removes the file from the account index and, when no other account references the root, drops the gateway's content index entry and hot cache copy. The on-chain storage deal cannot be erased and continues until its expiry, and the lifetime upload allowance is not restored. POST /api/v1/files/{root}/delete is an equivalent alias for clients that cannot send DELETE.

DEL/api/v1/files/{root}Try it

iNote

Requires a key with the files:write scope, sent as Authorization: Bearer <api-key>. Keys missing the scope are rejected with 403 — see Authentication.

Path parameters

Name	In	Type	Description
rootrequired	path	string	The Merkle root (content id) of the stored file.

Errors

Code	Meaning
401	Invalid or missing API key.
403	The API key lacks the required scope for this operation.
404	The root is not stored under this account.

cURL

curl -X DELETE https://gateway.kepto.xyz/api/v1/files/<root> \
  -H "Authorization: Bearer <api-key>"

200 · application/json

{
  "deleted": true,
  "root": "string",
  "indexedBytesRemoved": 0,
  "quotaBytesReleased": 0,
  "note": "string"
}