---
title: "Get Folder Tree"
method: GET
path: "/v1/external/workspaces/{workspaceGuid}/folders/tree"
tags: ["Folder"]
---

# Get Folder Tree

`GET /v1/external/workspaces/{workspaceGuid}/folders/tree`

Retrieve the workspace folder hierarchy as a nested tree.

Requires a **user** API key. The tree contains only folders you can access.
When a folder's parent is not accessible to you, the folder appears at the
root level of the tree instead.

## Path parameters

- `workspaceGuid` string, required

## Response `200`

Folder tree

- object
  - `content` FolderTreeNode[], required — Array of items
    - `id` string, required — Unique identifier for the folder
    - `title` string, required — Folder title
    - `parentId` string, nullable — Parent folder ID. `null` for root-level folders, or when the parent folder is not accessible to you — the folder then appears at the root level of the tree.
    - `depth` integer, required — Depth of the node in the returned tree (0 for root-level nodes)
    - `isAccessible` boolean, required — Whether you can access this folder's contents. The tree contains only folders you can access, so this is currently always `true`.
    - `children` FolderTreeNode[], required — Child folders, nested recursively.

## Other responses

- `401` — Unauthorized — missing API key, or a team-only key was used
- `403` — Forbidden — you are not a member of this workspace

---

[API](https://skmtc.dev/tiro/apis/tiro-api.md) · [All operations](https://skmtc.dev/tiro/apis/tiro-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/tiro/tiro-api/revisions/ae18d7961aa4/schema)