post
https://{app}.{filespin}.{io}/api/v1/assets/bulk/delete
API to delete assets in bulk. This soft deletes the asset which marks the original as deleted and removes all conversions and addons for an asset.
If anoriginalis deleted, all it's conversions will be deleted. If a deletedoriginalis restored, conversions that are enabled in the profile will be re-created.
Request JSON Parameters
| Key | Value | Description |
|---|---|---|
start_time | string | The start time for the range in ISO 8601 format. Date range is for the Asset Upload Time. |
end_time | string | The start time for the range in ISO 8601 format. Date range is for the Asset Upload Time. |
Example Request body
{
"start_time": "2025-01-20T00:00:00Z",
"end_time": "2025-01-30T23:59:59Z"
}Webhook callback and Database exports on asset deletion
For each asset deleted, callback/export is issued to configured Webhook/Database.
Please see Tools & Integration- > Webhooks and Database Export sections to learn about the callbacks.
HTTP Response
Returns a job id in below JSON if request was successful.
{
"status": "QUEUED",
"message": "Job queued",
"job_id": 947
}API Limits
This API is part of restricted APIs to prevent abuse and inadvertent actions. The limitations include:-
- API rate limits
- range limits such as total number of assets that can be deleted in one API call. Default is 1000 assets.
- range limits such as date ranges that can be used in API request. Default is 31 days.
These limits may be different for custom enterprise deployments. Please check with our Support team if needed.