# 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.

> Index of these docs: https://wavegrain.com/developers/llms.txt

**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](/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](/developers/authentication) shows how to make one.

```json
{
  "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`](/developers/mcp-tools/delete_slideshow): Delete a slideshow
- [`update_collection`](/developers/mcp-tools/update_collection): Rename a collection
- [`delete_collection`](/developers/mcp-tools/delete_collection): Delete a collection
- [`revoke_review_link`](/developers/mcp-tools/revoke_review_link): Turn off a review link
- [`pause_automation`](/developers/mcp-tools/pause_automation): Pause an automation
- [`skip_automation_run`](/developers/mcp-tools/skip_automation_run): Skip an automation's next run
- [All 79 tools](/developers/mcp-tools)
