Delete a vault folder
Deletes a folder you own. **Non-empty folders are allowed**: the items inside are preserved and fall back to "All" (unfiled) — nothing is removed from storage. System folders (compliance archives) cannot be deleted.
/api/external/vault/folders/{folderId}Deletes a folder you own. Non-empty folders are allowed: the items inside are preserved and fall back to "All" (unfiled) — nothing is removed from storage. System folders (compliance archives) cannot be deleted.
Authentication
Send the creator's API key as a bearer token: Authorization: Bearer dpfn_…. See Authentication & API keys.
An agency's own key can call this for a creator it manages by adding X-Dropfans-Account: <account id> (needs canManageVault). See Agencies.
Path parameters
| Name | Type | Required | Description |
|---|---|---|---|
folderId | string | Required | The folder id. |
Responses
| Name | Type | Description |
|---|---|---|
success | boolean | Always true. |
{
"success": true
}Errors
| Status | Body | When |
|---|---|---|
| 400 | {"error":"This folder is managed automatically and cannot be deleted."} | The folder is a system folder. |
| 401 | {"error":"Unauthorized","code":"unauthorized"} | Missing or invalid API key. |
| 404 | {"error":"Folder not found"} | No such folder on this account. |
| 500 | {"error":"Failed to delete vault folder"} | Write failed — retry later. |
| 400 | {"error":"X-Dropfans-Account must be an account id (from GET /api/external/agency/creators), not a username.","code":"invalid_account_header"} | `X-Dropfans-Account` is not an account id. |
| 403 | {"error":"This key cannot act for that account.","code":"account_not_managed"} | `X-Dropfans-Account` names an account this key cannot act for: not an agency’s own key, no ACCEPTED management, or the agency or account is suspended, banned or deleted (an unknown id gets the same answer). |
| 403 | {"error":"The agency does not have permission for this on that account.","code":"permission_denied","permission":"canManageVault"} | With `X-Dropfans-Account`: the agency lacks `canManageVault` on that account. |
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/folders/$FOLDER_ID" \
-H "Authorization: Bearer $DROPFANS_API_KEY"const folderId = '…'; // from an earlier response
const res = await fetch(`https://www.dropfans.io/api/external/vault/folders/${folderId}`, {
method: 'DELETE',
headers: {
Authorization: `Bearer ${process.env.DROPFANS_API_KEY}`,
},
});
console.log(await res.json());import os
import requests
folder_id = "…" # from an earlier response
res = requests.delete(
f"https://www.dropfans.io/api/external/vault/folders/{folder_id}",
headers={"Authorization": f"Bearer {os.environ['DROPFANS_API_KEY']}"},
)
print(res.json())Questions? [email protected]