Permanently delete an asset
Deletes the asset entirely — the database record, the stored file, and all associated data (faces, album links, etc.). Irreversible. Prefer trash_assets for the user’s standard delete action so accidents can be recovered.
Use remove_assets_from_album instead when the user only wants to remove an asset from a specific album but keep the file in their library. Use delete_album to remove an album without deleting its assets.
Path Parameters
Asset ID (with asset_ prefix) of the asset to permanently delete.
Response
Successful Response
Acknowledgment body returned by destructive endpoints (delete / trash / restore / permanently delete / remove-from-album / empty-trash).
Carries no fields — the HTTP 200 + empty JSON object is itself the success
signal. Exists so MCP tools generated from these endpoints have a real
outputSchema (rather than the null schema FastMCP emits for 204
responses), which ChatGPT's MCP submission tooling requires.