> ## 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.

# ノート & フォルダの編集

> ノートのタイトルを更新し、フォルダの名前変更・スタイル設定・移動・並べ替えを行う

## 概要

これら 4 つの書き込みツールを使うと、アシスタントがお客様に代わってノートとフォルダの構成を編集できます。

* **`update_note`** — ノートのタイトルを更新します。スコープ `mcp:notes:write`。
* **`update_folder`** — フォルダのタイトル・説明・色を更新します。スコープ `mcp:folders:write`。
* **`move_folder`** — フォルダを別の親の下へ、またはワークスペースのルートへ移動します。スコープ `mcp:folders:write`。
* **`reorder_folders`** — 同じ親の下にある兄弟フォルダを並べ替えます。スコープ `mcp:folders:write`。

**使用する場面:**

* 会議後、実際の内容を反映するようにノートのタイトルを付け直すとき。
* フォルダ名を変更したり、説明を整理したり、一目でグループがわかるように色を変えたりするとき。
* フォルダツリーを再構成するとき: フォルダを別のフォルダの下にネストする、ワークスペースのルートに昇格させる、兄弟フォルダの表示順を変える。

<Note>
  **user key と 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 による更新で、**渡したフィールドのみが変更され**、省略したフィールドはそのまま維持されます。少なくとも 1 つのフィールドが必須です。

### パラメータ

| 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` のうち少なくとも 1 つを指定する必要があります。省略したフィールドは変更されません。たとえばタイトルを再送信せずに色だけを変更できます。
</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

兄弟フォルダを並べ替えます。1 つの兄弟セットの**完全な**希望順を渡してください。ワークスペースは最初のフォルダ ID から推定されます。

### パラメータ

| Parameter          | Type      | Required | Description                                                                  |
| ------------------ | --------- | -------- | ---------------------------------------------------------------------------- |
| `orderedFolderIds` | string\[] | Required | 希望する兄弟順の全体（最小 1 個の ID）。すべての兄弟がちょうど 1 回ずつ含まれる必要があります。ワークスペースは最初の ID から推定されます。 |

### 例

**リクエスト:**

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

3 つの兄弟フォルダを指定した順序で並べ替えます。

**レスポンス:**

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

## スコープ要件

`update_note` は `mcp:notes:write` スコープを必要とし、`update_folder`、`move_folder`、`reorder_folders` は `mcp:folders:write` スコープを必要とします。

<Note>
  API key はすべてのスコープを持つため、有効な API key であればこれらのツールを呼び出せます。`mcp:notes:write` / `mcp:folders:write` スコープが意味を持つのは **OAuth ベースのクライアント** で、この場合は付与されたスコープによって呼び出せるツールが制御されます。
</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)** — ノートが属するフォルダの一覧を取得します。