DEdeepnote
Folders

List folders

Changed on

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

Request

  • Base URL
    https://api.deepnote.com/v2
  • URL
    https://api.deepnote.com/v2/folders
  • Auth
    HTTP bearer

Query parameters

nameContainsstring

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

Example:finance

Response

List of folders

Example response

{
  "folders": [
    {
      "id": "f35c32cb-a0fb-4136-a58d-54adf8448a98",
      "name": "Finance",
      "createdAt": "2026-08-14T10:30:00.000Z"
    }
  ]
}

Changes

  • 062f5f1b4638Revision changes
    • info

      the /// response's property pattern was changed from ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z))$ to ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d+)?(?:Z))$ for the status

  • f877869207bbRevision changes
    • info

      endpoint added