Deepnote research: our notes on building agents
Get started
All endpoint groups

Deepnote Public API v2

Folders API

Workspace folders that organize projects.

Base URL

https://api.deepnote.com/v2

List 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`.

get/folders

Parameters

nameContainsquerystring

Filter folders whose name contains this value (case-insensitive).

Responses

▸200List of folders
application/jsonListFoldersResponse
foldersrequiredFolder[]
▸400Validation error
application/jsonErrorResponse
messagerequiredstring
▸401Unauthorized
application/jsonErrorResponse
messagerequiredstring
▸403Insufficient permissions
application/jsonErrorResponse
messagerequiredstring
▸429Rate limit exceeded
application/jsonErrorResponse
messagerequiredstring