List folders
- OpenAPI 3.1.0 document: https://api.rollstack.com/public/v1/openapi.json
- The whole reference in Markdown: https://docs.rollstack.com/llms-full.txt
- An index of the reference: https://docs.rollstack.com/llms.txt
GET https://api.rollstack.com/public/v1/folders
The folders the user can see, each with its parent, null at the top level, and the user's permission on it: null, view, edit or manage. Pass a folder's id as folderId to listReports or createReport, or to getFolder to see who it's shared with.
Requires the slide_decks:read scope.
Operation ID: listFolders.
Response 200
Success
application/json: array of object
id(string, required): Unique identifier for the folder. Pass it asfolderIdtolistReportsto list the reports in it, or tocreateReportorupdateReportto put a report in it.name(string, required): The folder's name, as shown in Rollstack.parentFolderId(string or null, required): The folder this one is nested in.nullfor a folder at the top level. The parent is missing from the list when you can see this folder but not its parent.permission(string or null, required): What you can do in the folder.viewlets you open the reports in it,editalso lets you change them, andmanagealso lets you share the folder and change who has access to it. It is the highest of what the folder is shared with you directly and what you get from the folders it is nested in, where owning one of those givesmanage.nullwhen you own the folder and get nothing from a parent folder, as with a top-level folder you created: as its owner, you can do everything in it. One ofview,edit,manage.