Folders

Folders organize references into a hierarchical structure, similar to directories in a file system. Folders can contain subfolders.

A reference can belong to multiple folders without duplication. Removing a reference from a folder or deleting the folder does not delete the reference itself. Deleting a folder detaches its references by default; pass trash_references=true to move those references (and its subfolders' references) to the trash instead.

The folders list is not paginated — every matching folder is returned in a single response and cursor is always null. The references inside a folder (GET /folders/{folder_id}/references) are paginated like the main references list and return a real cursor. GET /folders/{folder_id}/folders returns the direct subfolders as a bare array (no pagination envelope).

Every folder operation is also available scoped to a specific library under /libraries/{library_id}/folders. The non-scoped form operates on your personal library; the scoped form targets one library, such as a shared library.

See the Folder object for the full schema.