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

> 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`

이 구조를 통해 어떤 노트가 어떤 폴더에 추가되었는지 명확하게 식별할 수 있어요.