Add to Collection
add_to_collectionAdd a research paper to a collection using its arXiv ID; collections support nested folders and are created if they don't exist. The paper is automatically saved to your library.
Instructions
Add a paper to a collection, addressed by collection_id OR collection_name (get-or-create by name — no need to look up an id first). Nest with "/": collection_name "AgentOPA/Formal" files the paper under an "AgentOPA" folder. MUTATES: also auto-saves the paper to the library. Idempotent (adding a paper already in the collection is a no-op). Requires SF_API_KEY.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| arxiv_id | Yes | arXiv ID of the paper to add, e.g. '2407.15831'. | |
| collection_name | No | Name of the collection. Created if it doesn't exist. Use '/' to nest, e.g. 'AgentOPA/Formal'. Provide this OR collection_id. | |
| collection_id | No | UUID of an existing collection. Provide this OR collection_name. |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| ok | No | True when the operation succeeded. | |
| message | No | Human-readable summary of the outcome. | |
| action | No | Machine label: saved | no_change | removed | liked | created | updated | deleted. | |
| arxiv_id | No | ||
| collection | No | The created/affected collection, when applicable. | |
| watch | No | The created/affected watch, when applicable. |