> ## Documentation Index
> Fetch the complete documentation index at: https://docs.drime.cloud/llms.txt
> Use this file to discover all available pages before exploring further.

# Get User Folders

> Get folder tree for a user

## Overview

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

## Path Parameters

<ParamField path="userId" type="integer" required>
  The user ID
</ParamField>

## Query Parameters

<ParamField query="workspaceId" type="integer">
  Filter by workspace. Use `0` for personal workspace.
</ParamField>

<ParamField query="vault" type="integer">
  Set to `1` to return only vault (encrypted) folders
</ParamField>

## Response

<ResponseField name="folders" type="array">
  Array of folder objects
</ResponseField>

<ResponseField name="rootFolder" type="object">
  Root folder information
</ResponseField>

<ResponseField name="status" type="string">
  Request status (`success`)
</ResponseField>

<RequestExample>
  ```bash cURL theme={null}
  curl "https://app.drime.cloud/api/v1/users/15843/folders?workspaceId=0" \
    -H "Authorization: Bearer YOUR_ACCESS_TOKEN"
  ```

  ```javascript JavaScript theme={null}
  const userId = 15843;

  const response = await fetch(
    `https://app.drime.cloud/api/v1/users/${userId}/folders?workspaceId=0`,
    {
      headers: {
        'Authorization': 'Bearer YOUR_ACCESS_TOKEN'
      }
    }
  );

  const { folders, rootFolder } = await response.json();
  ```

  ```python Python theme={null}
  import requests

  user_id = 15843

  response = requests.get(
      f'https://app.drime.cloud/api/v1/users/{user_id}/folders',
      params={'workspaceId': 0},
      headers={'Authorization': 'Bearer YOUR_ACCESS_TOKEN'}
  )

  data = response.json()
  folders = data['folders']
  root = data['rootFolder']
  ```
</RequestExample>

<ResponseExample>
  ```json 200 - Success theme={null}
  {
    "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"
  }
  ```
</ResponseExample>