Folders
Organize documents into folders outside of any dataroom.
List folders
Returns folders in the team library. Use `parent_id=root` to list top-level folders, or `parent_id=<id>` for direct children of a specific folder. Without `parent_id` returns every folder in the team.
Create a folder
Create a folder in the team library. The folder's `path` is derived server-side from its name and parent — clients never set it. If a sibling already has the chosen name, a numeric suffix is appended (e.g. `Pitches (1)`).
Get a folder
Returns a single folder by id.
Update a folder
Rename the folder or update its icon/color. Renaming rewrites the `path` of this folder and every descendant in a single transaction.
Delete a folder
Delete a folder. Refuses non-empty folders unless `cascade=true`, in which case every descendant folder and document is deleted.
Move a folder
Reparent a folder. Refuses moves into the folder itself or any of its descendants, and refuses if the target parent already has a sibling with the same slug. Descendant `path`s are rewritten in a single transaction.
Generate a presigned upload URL
Step 1 of the document upload flow. Returns a presigned S3 PUT URL and an opaque one-time `upload_id`. Upload the file bytes directly to `upload_url`, then call POST /v1/documents with that `upload_id`.
List folders
Returns folders in the team library. Use `parent_id=root` to list top-level folders, or `parent_id=<id>` for direct children of a specific folder. Without `parent_id` returns every folder in the team.