v64

latestOpenAPI 3.1.0raw.githubusercontent.com2026-08-016280256.4 KB
assets

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.

delete/api/assets/{asset_id}

Path parameters

asset_idstring required

Asset ID (with asset_ prefix) of the asset to permanently delete.

Asset ID (with asset_ prefix) of the asset to permanently delete.

Response

Successful Response

DeletionResponse required

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.