Folders
Create and manage folders inside a space, and see who has access.
Get Folders
Pages folders under a space (`folders[]`, not `items`). Simple: `?limit=20` then `?limit=20&cursor={nextCursor}`. Deep-link: add `anchorId` of a known folder to load a window centered on it. Location comes from the token.
Create Folder
Creates a folder inside a space. Folders group lists; a default list is seeded server-side but omitted from the public response.
Get Folder
Fetches one folder by id.
Update Folder
Updates folder fields such as name, color, or privacy. `color` must be a palette swatch. `userIds` when making the folder private adds grants and does not revoke omitted users — use `DELETE /projects/folders/{folderId}/users/{userId}`. Setting `isPrivate: false` makes the folder public; existing direct grants remain but no longer gate access while public.
Delete Folder
Deletes a folder and its nested lists. Response: `{ 'success': true }` (no `id`).
Get Users With Folder Access
Lists users with access to the folder as one unified `users` page (`source`: `direct` | `inherited`). `skip` / `limit` / `total` apply to the combined list. No PII and no `query` filter. Revoke with `DELETE /projects/folders/{folderId}/users/{userId}`.
Revoke Folder Member
Revokes a direct user grant on the folder. Idempotent if the grant is already absent. Does not change `isPrivate`. Inherited access from ancestors is unchanged.