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

InputTypeRequiredNotes
collectionIdstringyesThe collection the images are in, from list_collections. up to 200 characters
action"remove" | "move"yesremove: out of this collection. move: into targetCollectionId.
itemIdsstring[]yesitemId values from list_collection_images. up to 200 items
targetCollectionIdstringnoFor 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

FieldTypeNotes
collectionIdstringThe collection changed.
affectednumberHow many images were moved or removed.
notestringWhat 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.

Something wrong or missing? Write to support@wavegrain.com.