Storage

Unpin a stored file (POST alias of DELETE /api/v1/files/{root})

Requires scope files:write. Identical to DELETE /api/v1/files/{root}; provided for clients that cannot send DELETE requests.

POST/api/v1/files/{root}/deleteTry 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 POST https://gateway.kepto.xyz/api/v1/files/<root>/delete \
  -H "Authorization: Bearer <api-key>"

200 · application/json

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

cURL

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

200 · application/json

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