API reference
Delete (hide) a vault item
Soft-deletes a vault item you own: nothing is removed from storage, the item is hidden and disappears from every list.
View as MarkdownUpdated Aug 19, 2026
DELETE
/api/external/vault/{id}Soft-deletes a vault item you own: nothing is removed from storage, the item is hidden and disappears from every list.
Idempotent — deleting an already-hidden item is a success, so blind retries are harmless.
Authentication
Send the creator's API key as a bearer token: Authorization: Bearer dpfn_…. See Authentication & API keys.
Path parameters
| Name | Type | Required | Description |
|---|---|---|---|
id | string | Required | The vault item id. |
Responses
200Hidden (or already hidden).
| Name | Type | Description |
|---|---|---|
success | boolean | Always true. |
Example response
{
"success": true
}Errors
| Status | Body | When |
|---|---|---|
| 401 | {"error":"Unauthorized","code":"unauthorized"} | Missing or invalid API key. |
| 404 | {"error":"Vault item not found"} | No item with that id on this creator’s account (other creators’ ids also 404 — never 403). |
| 500 | {"error":"Failed to delete vault item"} | Write failed — retry later. |
Rate limiting
Every response carries the X-RateLimit-Tier header and, on limited tiers, the per-minute and per-day trios — read X-RateLimit-Remaining and X-RateLimit-Reset instead of hardcoding limits. Details in Rate limits.
Code samples
curl -X DELETE "https://www.dropfans.io/api/external/vault/$VAULT_ITEM_ID" \
-H "Authorization: Bearer $DROPFANS_API_KEY"const vaultItemId = '…'; // from an earlier response
const res = await fetch(`https://www.dropfans.io/api/external/vault/${vaultItemId}`, {
method: 'DELETE',
headers: {
Authorization: `Bearer ${process.env.DROPFANS_API_KEY}`,
},
});
console.log(await res.json());import os
import requests
vault_item_id = "…" # from an earlier response
res = requests.delete(
f"https://www.dropfans.io/api/external/vault/{vault_item_id}",
headers={"Authorization": f"Bearer {os.environ['DROPFANS_API_KEY']}"},
)
print(res.json())Questions? [email protected]