Purge multiple storage items based on filtering criteria such as age, MIME type, or metadata. Use this for bulk cleanup operations.
Authorization
Bearer token for authentication. Format: Bearer <your-api-key>
Required Permission
STORAGE_WRITE
Request Body
Filter by file kind. Available values: image, video, audio, document
ISO 8601 date - purge items created before this date
ISO 8601 date - purge items created after this date
Response
Success message indicating the operation result
Number of items purged (or would be purged if dry run)
curl -X DELETE "https://api.nonefivem.com/cloud/storage/purge" \
-H "Authorization: Bearer your-api-key" \
-H "Content-Type: application/json" \
-d '{
"kind": "image",
"before": "2025-01-01T00:00:00Z"
}'
{
"message": "42 items purged successfully",
"purgedCount": 42
}
This action is irreversible. Deleted files cannot be recovered.
Combine kind, before, and after to target specific files. For example,
purge all images created before a specific date.