edit_collection_images
Remove or move collection images with Wavegrain's MCP server: the edit_collection_images tool needs the write permission. Inputs, outputs and an example call.
Remove or move collection images. Permission: write. Changes or removes saved work.
Remove images from a collection, or move them to another, by itemId. They stay in the Media library.
Inputs
| Input | Type | Required | Notes |
|---|---|---|---|
collectionId | string | yes | The collection the images are in, from list_collections. up to 200 characters |
action | "remove" | "move" | yes | remove: out of this collection. move: into targetCollectionId. |
itemIds | string[] | yes | itemId values from list_collection_images. up to 200 items |
targetCollectionId | string | no | For move: another of the user's collections. up to 200 characters |
The fields inside an object or a list are in the JSON Schema at /developers/mcp-tools.json.
Returns
| Field | Type | Notes |
|---|---|---|
collectionId | string | The collection changed. |
affected | number | How many images were moved or removed. |
note | string | What to tell the user. |
Example call
Send it to POST https://wavegrain.com/api/mcp with an access key that has the write permission; Authentication shows how to make one.
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "edit_collection_images",
"arguments": {
"collectionId": "<collectionId>",
"action": "remove",
"itemIds": [
"<itemId>"
]
}
}
}
The call shows only the required inputs, with placeholder values: put your own in.
Related tools
delete_slideshow: Delete a slideshowupdate_collection: Rename a collectiondelete_collection: Delete a collectionrevoke_review_link: Turn off a review linkpause_automation: Pause an automationskip_automation_run: Skip an automation's next run- All 79 tools
Something wrong or missing? Write to support@wavegrain.com.