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

# FolderNote イベント

> FolderNoteRelation リソースに関する webhook イベント

export const EventBaseStructure = {
  id: "evt_01J9ABCDEF",
  type: "note.created",
  createdAt: "2025-09-05T07:12:34Z",
  workspaceGuid: "ws_a1b2c3d4",
  data: {
    resourceType: "Note",
    resourceId: "note-guid-123",
    resource: {
      "title": "Meeting Note"
    }
  }
};

export const Json = ({data, lang = 'json', spaces = 2}) => <pre>
    <code className={`language-${lang}`}>{JSON.stringify(data, null, spaces)}</code>
  </pre>;

## 概要

FolderNoteRelation リソースに関する webhook イベントです。これらのイベントは、フォルダとノートの関係を追跡します。すべての FolderNote イベントは `resourceType: "FolderNoteRelation"` を使用します。

## イベントの詳細

Resource ID のパターン: `folder_{folderId}:note_{noteGuid}`

### folder.note.added

* ノートがフォルダに追加されたときにトリガーされます

### folder.note.removed

* ノートがフォルダから削除されたときにトリガーされます

## payload の例

### folder.note.added

<Json
  data={{
...EventBaseStructure,
type: "folder.note.added",
data: {
...EventBaseStructure.data,
resourceType: "FolderNoteRelation",
resourceId: "folder_123:note_IA8BgAct0ZkBk",
resource: {
  folder: {
    id: "123",
    title: "Project Meeting",
    isTeamFolder: true
  },
  noteGuid: "IA8BgAct0ZkBk"
}
}
}}
/>

### folder.note.removed

<Json
  data={{
...EventBaseStructure,
type: "folder.note.removed",
data: {
...EventBaseStructure.data,
resourceType: "FolderNoteRelation",
resourceId: "folder_123:note_IA8BgAct0ZkBk",
resource: {
  folder: {
    id: "123",
    title: "Project Meeting",
    isTeamFolder: true
  },
  noteGuid: "IA8BgAct0ZkBk"
}
}
}}
/>

## リソースデータの構造

### FolderNoteRelationExternalEventData

<ParamField body="folder" type="object" required>
  フォルダの情報
</ParamField>

<ParamField body="folder.id" type="string" required>
  フォルダ ID（文字列形式）
</ParamField>

<ParamField body="folder.title" type="string" required>
  フォルダのタイトル
</ParamField>

<ParamField body="folder.isTeamFolder" type="boolean" required>
  チームフォルダかどうか（teamNoteSharingType が null でない場合は true）
</ParamField>

<ParamField body="noteGuid" type="string" required>
  追加されたノートの GUID
</ParamField>

## Resource ID の構造

Resource ID は、フォルダとノートの両方を識別できる複合構造を使用します。

```
folder_{folderId}:note_{noteGuid}
```

**例:**

* `folder_123:note_IA8BgAct0ZkBk`
* `folder_456:note_oKqMhoYTHlPrt2`

この構造によって、どのノートがどのフォルダに追加されたのかを明確に識別できます。