Delete image
delete_mediaDestructiveIdempotent
Permanently delete an uploaded image by id. The URL stops working immediately. Posts that referenced it will show a broken image until edited.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| blog_id | No | Your blog's id, as returned by signup. Optional with an API key: it defaults to the key's blog, and any id you pass must be that blog. Required when the server runs without API keys. | |
| media_id | Yes | Id of the image (`media.id` from upload_media or list_media). | |
| idempotency_key | No | Optional retry key, any unique string (e.g. a UUID). Retrying with the same key and identical arguments returns the first result instead of writing again; the same key with different arguments fails with IDEMPOTENCY_KEY_CONFLICT. Scoped to your API key and this tool. |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| error | No | Present only on failure (isError: true). Success fields are absent then. | |
| deleted | No |