---
title: "Attach Note to Folder"
method: POST
path: "/v1/external/folders/{folderId}/notes"
tags: ["Folder"]
---

# Attach Note to Folder

`POST /v1/external/folders/{folderId}/notes`

## Request

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

Add an existing note to the folder. The note must belong to the same
workspace as the folder. Requires edit access to the folder.

Attaching a note that is already in the folder succeeds with no effect,
so the call is safe to retry.

## Path parameters

- `folderId` string, required

## Request body

- AttachNoteRequest: Attach an existing note to a folder.
  - `noteGuid` string, required: GUID of the note to attach. The note must belong to the same workspace as the folder.

## Response `204`

Note attached

## Other responses

- `400`: Bad request — the note belongs to a different workspace
- `401`: Unauthorized — missing API key, or a team-only key was used
- `403`: Forbidden — no edit access to this folder
- `404`: Folder or note not found

---

[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)