Kalpana Docs
Resources

Delete an asset

Delete an image for good.

DELETE /api/assets/{id}

Requires assets:delete.

FieldRequiredDescription
workspaceYesWorkspace 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

StatusCause
403Your role or key lacks assets:delete.
404The asset is not in this workspace.
500The image is still in use, as above. The message is Failed to delete asset.
Was this page helpful?

Updated 4 Nov 2026

On this page