Delete Images
delete_imagesDelete one or more existing image assets that the user can access, including Brand Library images. Use image IDs, not selected-model generation-job IDs.
The images stop appearing in image list, search, and read results. Re-deleting an already-deleted image is a no-op.
Only call this when the user has explicitly asked to delete specific images. For bulk cleanup, first list the candidates with list_images and confirm the exact set with the user.
deleted_count may be lower than the number of IDs passed: images the user cannot delete, or that were already deleted, are skipped rather than erroring.
Args:
image_ids: Image IDs to delete, from list_images or generation outputs' media IDs. Do not pass the job IDs returned by generate_image.
Returns: { "deleted_count": number, "message_for_assistant"?: string }
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"image_ids": "<image_ids>"
},
"name": "delete_images"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| image_ids | Yes | IDs of the image assets the user asked to delete. Take them from list_images or generation outputs' media IDs. Generation-job IDs returned by generate_image cannot identify images for deletion. | |
| llm_model | No | The model identifier you are running as, for example "claude-opus-4-8" or "gpt-5.2". Omit it or pass "unknown" if you are not certain; the tool runs the same either way. Recorded only for the server developer's analytics. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| deleted_count | Yes | Number of images deleted. Skipped IDs are not counted. | |
| message_for_assistant | No | Context, explanations, or actionable guidance for the calling assistant. Hosts may display it, but it is not copy that must be shown to the user verbatim. |