개요
FolderNoteRelation 리소스에 대한 webhook 이벤트예요. 이 이벤트들은 폴더와 노트 사이의 관계를 추적해요. 모든 FolderNote 이벤트는resourceType: "FolderNoteRelation"을 사용해요.
폴더 이벤트도 노트 이벤트와 같은 범위를 따라요. 워크스페이스 Webhook은 워크스페이스 전체 구성원에게 공유된 폴더에서 일어난 변화만 발송되고, 개인 폴더나 일부 구성원에게만 공유한 폴더의 변화는 발송되지 않아요. 조직 Webhook은 조직 소속 워크스페이스에서 전체 구성원에게 공유된 폴더의 변화만 받아요(워크스페이스 Webhook과 같은 범위). 계정 Webhook은 사용자가 접근할 수 있는 폴더라면 일부 구성원에게만 공유한(LIMITED) 폴더의 이벤트도 받아요. 이 범위가 적용되기 전에 등록한 레거시 시스템 endpoint는 당분간 예전처럼 동작해요. 자세한 내용은 시스템 API Key가 조회하는 노트 범위를 참고하세요.
이벤트 상세
Resource ID 패턴:folder_{folderId}:note_{noteGuid}
folder.note.added
- 노트가 폴더에 추가될 때 발생해요
folder.note.removed
- 노트가 폴더에서 제거될 때 발생해요
Payload 예시
folder.note.added
folder.note.removed
리소스 데이터 구조
FolderNoteRelationExternalEventData
object
필수
폴더 정보
string
필수
폴더 ID (문자열 형태)
string
필수
폴더 제목
boolean
필수
폴더의 공유 설정이
PRIVATE가 아니면 true예요 (일부 구성원에게만 공유한 LIMITED 폴더도 포함돼요). 워크스페이스 Webhook이 실제로 이벤트를 보내는 범위는 워크스페이스 전체 구성원에게 공유된 폴더뿐이라, isTeamFolder만으로는 이벤트 발송 대상 폴더인지 판단할 수 없어요. (계정 Webhook과 레거시 시스템 endpoint의 예외는 위 개요를 참고하세요.)string
필수
추가된 노트의 GUID