Assets
delete_asset
Permanently delete an asset, its bytes and thumbnail. Requires `confirm: true` — pass true only after the human operator has agreed. Blocked with E_ASSET_IN_USE while linked from a published site; details.linking_sites lists the blockers.
Behaviour
- Effect
- Destructive. It can remove or overwrite existing data.
- Repeat calls
- Not idempotent. Repeating the call can produce a further change.
- Plan
- Available on every plan, including free.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
| asset_id | uuid | Yes | - |
| confirm | boolean | Yes | Set to true only after the human operator has agreed to permanently delete this asset. Passing false (or omitting) raises E_CONFIRM_REQUIRED, which is the intended machine-readable signal to stop and ask the human. |
Returns
| Name | Type |
|---|---|
| deleted | true |
| asset_id | uuid |
| hash | string |
| storage_removed | boolean |
| thumb_removed | boolean |
| idempotency_replay | false |
Using it
delete_asset is called by an AI assistant connected to Sentway over MCP, not by hand. Point the assistant at the Sentway MCP endpoint and complete the OAuth flow, and the tool becomes available in the same session as the other 56 Sentway tools. See connecting over MCP.