Skip to main content
GET
/
users
/
{userId}
/
folders
curl "https://app.drime.cloud/api/v1/users/15843/folders?workspaceId=0" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"
{
  "folders": [
    {
      "id": 111344,
      "name": "Documents",
      "parent_id": null,
      "path": "111344",
      "type": "folder",
      "workspace_id": 0,
      "permissions": {
        "files.update": true,
        "files.create": true,
        "files.download": true,
        "files.delete": true
      },
      "hash": "MTExMzQ0fHBhZA"
    },
    {
      "id": 111345,
      "name": "Photos",
      "parent_id": null,
      "path": "111345",
      "type": "folder",
      "workspace_id": 0
    }
  ],
  "rootFolder": {
    "type": "folder",
    "id": 0,
    "hash": "0",
    "path": "",
    "name": "All Files",
    "workspace_id": 0
  },
  "status": "success"
}

Overview

Returns the folder structure for a user, useful for building folder tree navigation.

Path Parameters

userId
integer
required
The user ID

Query Parameters

workspaceId
integer
Filter by workspace. Use 0 for personal workspace.
vault
integer
Set to 1 to return only vault (encrypted) folders

Response

folders
array
Array of folder objects
rootFolder
object
Root folder information
status
string
Request status (success)
curl "https://app.drime.cloud/api/v1/users/15843/folders?workspaceId=0" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"
{
  "folders": [
    {
      "id": 111344,
      "name": "Documents",
      "parent_id": null,
      "path": "111344",
      "type": "folder",
      "workspace_id": 0,
      "permissions": {
        "files.update": true,
        "files.create": true,
        "files.download": true,
        "files.delete": true
      },
      "hash": "MTExMzQ0fHBhZA"
    },
    {
      "id": 111345,
      "name": "Photos",
      "parent_id": null,
      "path": "111345",
      "type": "folder",
      "workspace_id": 0
    }
  ],
  "rootFolder": {
    "type": "folder",
    "id": 0,
    "hash": "0",
    "path": "",
    "name": "All Files",
    "workspace_id": 0
  },
  "status": "success"
}