Create folder
- 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
POST https://api.rollstack.com/public/v1/folders
Creates a folder owned by the user: at the top level, which only owners and admins of the organization may, or inside a folder the user owns or has manage on. Then file reports in it with updateReport's folderId, or create them there with createReport. Each call creates another folder, even with the same name.
Requires the slide_decks:write scope.
Operation ID: createFolder.
Headers
Idempotency-Key(string): A unique value, such as a UUID, that makes retrying this call safe. A retry with the same key within 24 hours answers the first call's result instead of running it again. Use a new key for each new call. From 1 to 255 printable ASCII characters.
Request body, required
application/json
name(string, required): The folder's name, as members will see it in Rollstack. Leading and trailing spaces are removed, and it can't be blank. Example:Q3 business reviews.parentFolderId(string or null): The folder to create it in, by itsidfromlistFolders: one you own or havemanageon. Omit it or passnullto create it at the top level, which only owners and admins of the organization may. Example:a3d5e7f9-1b2c-4d6e-8f0a-1b2c3d4e5f6a.
Response 201
Success
application/json
id(string, required): Unique identifier for the folder.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.permission(string or null, required): What you can do in the folder:view,editormanage, as inlistFolders.managewhen you own it.nullwhen you see it only because a report in it is shared with you. One ofview,edit,manage.access(array of object, required): Everyone with access to the folder, the owner first.userId(number, required): The member's user id, the same as theiridinlistMembers.name(string, required): The member's name, as shown in Rollstack.email(string, required): The member's email address.permission(string, required): What they can do in the folder. The owner hasmanage. One ofview,edit,manage.source(string, required):ownerfor the member who owns the folder,directwhen it is shared with them,folderwhen they reach it through a folder it is nested in, whichunshareFolderon this folder leaves as it is. One ofowner,direct,folder.folder(string): Withfolder: the name of the parent folder they reach it through, when you can see that folder.