Resources
Delete an asset
Delete an image for good.
DELETE /api/assets/{id}Requires assets:delete.
| Field | Required | Description |
|---|---|---|
workspace | Yes | Workspace slug or id. |
curl --request DELETE "https://app.kalpana.one/api/assets/ASSET_ID" \
--header "x-api-key: $KALPANA_API_KEY" \
--header "content-type: application/json" \
--data '{"workspace":"acme"}'Response
{ "success": true }The image is removed from the workspace, from every image collection and from storage. It cannot be recovered.
An image that a template is linked to, or that an AI image edit was made from, cannot be deleted. The request fails and the image stays. This includes links from templates that have since been deleted. Delete several assets skips images used by live templates and reports them as inUse instead of failing.
Errors
| Status | Cause |
|---|---|
403 | Your role or key lacks assets:delete. |
404 | The asset is not in this workspace. |
500 | The image is still in use, as above. The message is Failed to delete asset. |
Was this page helpful?
Updated 4 Nov 2026