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

# 노트 & 폴더 편집

> 노트 제목을 수정하고 폴더 이름 변경·스타일 지정·이동·순서 변경

## 개요

이 네 가지 쓰기 도구를 사용하면 어시스턴트가 사용자를 대신해 노트와 폴더 구성을 편집할 수 있어요:

* **`update_note`** — 노트 제목을 수정해요. Scope `mcp:notes:write`.
* **`update_folder`** — 폴더의 제목, 설명, 색상을 수정해요. Scope `mcp:folders:write`.
* **`move_folder`** — 폴더를 다른 부모 아래로 이동하거나 워크스페이스 루트로 옮겨요. Scope `mcp:folders:write`.
* **`reorder_folders`** — 같은 부모 아래 형제 폴더의 순서를 변경해요. Scope `mcp:folders:write`.

**사용 시점:**

* 회의가 끝난 뒤 실제 내용에 맞게 노트 제목을 다시 붙일 때.
* 폴더 이름을 바꾸거나 설명을 정리하거나 한눈에 구분되도록 색상을 바꿀 때.
* 폴더 트리를 재구성할 때: 폴더를 다른 폴더 아래로 넣거나, 워크스페이스 루트로 올리거나, 형제 폴더가 표시되는 순서를 바꿀 때.

<Note>
  **user key vs. workspace-system key (폴더 도구).** `update_folder`, `move_folder`, `reorder_folders`의 경우: **user** API key는 편집 권한이 있는 폴더(개인 또는 팀)라면 무엇이든 편집할 수 있어요. **workspace-system** API key는 **TEAM(워크스페이스 공유) 폴더만** 편집할 수 있고, 개인 폴더를 편집하려는 시도는 거부돼요. `update_note`는 user, workspace, organization API key 모두에서 동작해요.
</Note>

## update\_note

노트 제목을 수정해요.

### 파라미터

| Parameter  | Type   | Required | Description                  |
| ---------- | ------ | -------- | ---------------------------- |
| `noteGuid` | string | Required | 수정할 노트의 GUID.                |
| `title`    | string | Required | 새 노트 제목. 1–100자, 공백만으로는 안 됨. |

### 예시

**요청:**

```json theme={"system"}
{
  "noteGuid": "note_9f8c2a1b",
  "title": "Q1 Planning — Kickoff"
}
```

**응답:**

```json theme={"system"}
{
  "noteGuid": "note_9f8c2a1b",
  "title": "Q1 Planning — Kickoff",
  "updatedAt": "2026-07-14T09:30:00Z"
}
```

## update\_folder

폴더의 제목, 설명, 색상을 수정해요. AIP-134 field-mask 업데이트로, **전달한 필드만 변경**되고 생략한 필드는 그대로 유지돼요. 최소 한 개 필드는 필수예요.

### 파라미터

| Parameter     | Type   | Required | Description                   |
| ------------- | ------ | -------- | ----------------------------- |
| `folderId`    | string | Required | 수정할 폴더의 ID.                   |
| `title`       | string | Optional | 새 폴더 제목. 1–50자, 공백만으로는 안 됨.   |
| `description` | string | Optional | 새 설명. 빈 문자열(`""`)을 전달하면 지워져요. |
| `color`       | string | Optional | `#RRGGBB` hex 문자열 형식의 폴더 색상.  |

<Note>
  `title`, `description`, `color` 중 최소 하나는 반드시 전달해야 해요. 생략한 필드는 변경되지 않아요. 예를 들어 제목을 다시 보내지 않고도 색상만 바꿀 수 있어요.
</Note>

### 예시

**요청:**

```json theme={"system"}
{
  "folderId": "12345",
  "title": "Engineering",
  "color": "#4C6EF5"
}
```

**응답:**

```json theme={"system"}
{
  "folderId": "12345",
  "title": "Engineering",
  "description": "Engineering team notes",
  "color": "#4C6EF5"
}
```

## move\_folder

폴더를 다른 부모 아래로 이동하거나 워크스페이스 루트로 옮겨요.

### 파라미터

| Parameter     | Type   | Required | Description                                         |
| ------------- | ------ | -------- | --------------------------------------------------- |
| `folderId`    | string | Required | 이동할 폴더의 ID.                                         |
| `newParentId` | string | Optional | 새 부모 폴더의 ID. `null`을 전달하거나 생략하면 폴더를 워크스페이스 루트로 옮겨요. |

### 예시

**요청:**

```json theme={"system"}
{
  "folderId": "12346",
  "newParentId": "12345"
}
```

폴더 `12346`을 폴더 `12345` 아래로 이동해요.

**응답:**

```json theme={"system"}
{
  "folderId": "12346",
  "title": "Q1 Planning",
  "parentId": "12345"
}
```

폴더를 워크스페이스 루트로 옮기려면 `newParentId`를 생략하거나 `null`을 전달하세요:

**요청:**

```json theme={"system"}
{
  "folderId": "12346"
}
```

## reorder\_folders

형제 폴더의 순서를 변경해요. 한 형제 집합의 **완전한** 원하는 순서를 전달하세요. 워크스페이스는 첫 번째 폴더 ID에서 추론돼요.

### 파라미터

| Parameter          | Type      | Required | Description                                                             |
| ------------------ | --------- | -------- | ----------------------------------------------------------------------- |
| `orderedFolderIds` | string\[] | Required | 원하는 형제 순서 전체(최소 1개 ID). 모든 형제가 정확히 한 번씩 나와야 해요. 워크스페이스는 첫 번째 ID에서 추론돼요. |

### 예시

**요청:**

```json theme={"system"}
{
  "orderedFolderIds": ["12347", "12345", "12346"]
}
```

세 형제 폴더를 주어진 순서로 재정렬해요.

**응답:**

```json theme={"system"}
{
  "orderedFolderIds": ["12347", "12345", "12346"]
}
```

## scope 요구 사항

`update_note`는 `mcp:notes:write` scope가 필요하고, `update_folder`, `move_folder`, `reorder_folders`는 `mcp:folders:write` scope가 필요해요.

<Note>
  API key는 모든 scope를 가지므로, 유효한 API key라면 이 도구들을 호출할 수 있어요. `mcp:notes:write` / `mcp:folders:write` scope는 **OAuth 기반 클라이언트**에서 의미가 있는데, 이 경우 부여된 scope가 어떤 도구를 호출할 수 있는지를 결정해요.
</Note>

API key는 [Tiro Platform API Keys](https://platform.tiro.ooo/dashboard/api-keys)에서 구성하세요.

## 관련 도구

* **[`get_note`](./get-note)** — 제목을 수정하기 전에 노트의 현재 메타데이터를 확인해요.
* **[폴더 검색](./folder-search)** — 편집·이동·순서 변경 전에 이름으로 폴더의 `folderId`를 찾아요.
* **[`get_note_folders`](./get-note-folders)** — 노트가 속한 폴더 목록을 확인해요.