edit_collection

com.kythene/kythene · Verify this server

Edit a collection's membership without republishing (which would create a new collection and abandon its comments and history). `action` is one of: "add" - append new `artifacts` (name, mime, content) and/or `existing_artifact_ids` (already-published files of the same space); files already in the collection are skipped, so it is safe to retry. "reorder" - set the full order: `artifact_ids` must be the FULL current member set, every file once (a partial or unknown-id list is rejected; work from a fresh get_collection). "move" - move `artifact_id` from this collection to `to_collection_id` in the same workspace, carrying its comments, reviews and history; if that empties the source it archives itself (a cross-workspace move is refused - share instead). Returns a lean ack (revision, or from_revision/to_revision for a move) plus `share_code_holders` when the edit exposes files to a share code - re-read with get_collection if you need the full state. WARNING: adding/moving into a share-coded collection makes those files readable by the code's holders. Refuses archived and memory collections. For a larger or binary file use `kythe add <collection-id> <file>`, which streams bytes off disk - up to 32 MiB per artifact - rather than through the model. Over MCP the whole request is limited to 1048576 bytes, and base64 inflates content by 4/3, so roughly 786432 bytes of file is the practical maximum here. Larger content goes over the API or the CLI, which have no such ceiling.