Assets

delete_asset

Permanently delete an asset from the account, including its stored bytes and thumbnail. Requires `confirm: true` — pass `true` only after the human operator has agreed to the deletion, not as a default. Blocked (E_ASSET_IN_USE) while the asset is linked from any 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

NameTypeRequiredDescription
asset_iduuidYes
confirmbooleanYesSet 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

NameTypeDescription
deletedtrue
asset_iduuid
hashstring
storage_removedboolean
thumb_removedboolean
idempotency_replayfalse

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 38 Sentway tools. See connecting over MCP.