---
title: "List Folders by Note"
method: GET
path: "/v1/external/notes/{noteGuid}/folders"
tags: ["Folder"]
---

# List Folders by Note

`GET /v1/external/notes/{noteGuid}/folders`

## Request

- Base URL: `https://api.tiro.ooo`
- URL: `https://api.tiro.ooo/v1/external/notes/{noteGuid}/folders`
- Auth: HTTP bearer

Retrieve folders for a specific note

## Path parameters

- `noteGuid` string, required

## Response `200`

List of folders

- object
  - `content` Folder[], required: Array of items
    - `id` string, required: Unique identifier for the folder
    - `title` string, required: Folder title
    - `workspaceGuid` string, nullable: GUID of the workspace the folder belongs to. `null` for legacy personal folders that have not been migrated to a workspace.
    - `isTeamFolder` boolean, required: `true` when the folder is shared with the workspace; `false` for personal (`PRIVATE`) folders. Retained for backward compatibility.

## Other responses

- `401`: Unauthorized
- `404`: Not found. The note does not exist, or it is outside the read scope of the API key used. A system key reads only notes in a folder shared with all workspace members, and returns `404` (not `403`) for anything outside that scope so the response does not reveal whether the note exists. A note that used to be readable and now returns `404` may have moved into a private folder.

---

[API](https://skmtc.dev/tiro/apis/tiro-api-2.md) · [All operations](https://skmtc.dev/tiro/apis/tiro-api-2/llms.txt) · [OpenAPI document](https://skmtc.dev/tiro/apis/tiro-api-2/revisions/dc1a260c6771?raw)