move_item_to_different_library
Move a Zotero item to a different library by recreating it under a new key and deleting the original, breaking any citations that reference the original key.
Instructions
DESTRUCTIVE -- moves an item to a different Zotero library (e.g. from this user library into a group library, or vice versa). Zotero has no native cross-library move: this recreates the item in the target library under a BRAND-NEW key, then deletes the original.
Any Word citation referencing the original key is broken by this, exactly like delete_item_permanently -- silently and permanently. If the goal is just reorganizing within THIS library, use add_to_collection/remove_from_collection instead -- those preserve the key and citations keep working.
target_library_id/target_library_type: the destination library; the configured ZOTERO_API_KEY must have write access to it. version: the item's current version in the source library (from search_items/get_item) -- refused if stale. idempotency_key: strongly recommended for this tool specifically. If the create-in-target step succeeds but the delete-from-source step then fails, this operation ends up erroring while the item now exists in BOTH libraries -- a bare retry would redo the whole thing and create a SECOND duplicate in the target library, since the source item's version hasn't changed. Passing the same idempotency_key on retry replays the original failure (and its "clean up manually" guidance) instead of touching Zotero again. Also protects the normal success path the same way delete_item_permanently's does.
Returns old_key and new_key -- report both to the caller so anyone relying on the old key knows it changed.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| key | Yes | ||
| version | Yes | ||
| idempotency_key | No | ||
| target_library_id | Yes | ||
| target_library_type | Yes |