Deepnote Public API v2
Folders API
Workspace folders that organize projects.
Base URL
https://api.deepnote.com/v2List folders
List workspace folders with their parent relationships in one response. Omit `nameContains` to receive the complete tree. Use this to resolve a folder name or nested path to the `folderId` accepted by `POST /projects`.
/foldersParameters
nameContainsquerystringFilter folders whose name contains this value (case-insensitive).
Responses
▸200List of folders
ListFoldersResponsefoldersrequiredFolder[]▸400Validation error
ErrorResponsemessagerequiredstring▸401Unauthorized
ErrorResponsemessagerequiredstring▸403Insufficient permissions
ErrorResponsemessagerequiredstring▸429Rate limit exceeded
ErrorResponsemessagerequiredstringCreate a folder
Create a workspace folder, optionally inside another folder. Folder names are not unique, so check `GET /folders` first to avoid creating a duplicate. The new folder is listed by `GET /folders` right away, and its `id` is accepted as `folderId` by `POST /projects` and `PATCH /projects/{projectId}`.
/foldersRequest body
CreateFolderBodynamerequiredstringFolder name.
parentFolderIdstring:uuidFolder to create the new folder in. Omit to create it at the workspace root. Resolve a folder name to its ID via `GET /folders`.
Responses
▸201Folder created
CreateFolderResponsefolderrequiredFolder▸400Validation error
ErrorResponsemessagerequiredstring▸401Unauthorized
ErrorResponsemessagerequiredstring▸403Insufficient permissions
ErrorResponsemessagerequiredstring▸404Parent folder not found
ErrorResponsemessagerequiredstring▸429Rate limit exceeded
ErrorResponsemessagerequiredstring