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

# Note

> 표준 Note 데이터 모델

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

export const NoteFieldList = <ul>
    <li><strong>guid</strong>: Unique identifier for the note</li>
    <li><strong>workspaceGuid</strong>: GUID of the workspace the note belongs to (<code>null</code> if not associated with a workspace)</li>
    <li><strong>title</strong>: Note title</li>
    <li><strong>createdAt</strong> / <strong>updatedAt</strong>: ISO-8601 timestamps for creation and last modification</li>
    <li><strong>sourceType</strong>: Source type (<code>live-voice</code>, <code>recording</code>, <code>text</code>, <code>video</code>, <code>webpage</code>, <code>offline-mode</code>, <code>onboarding</code>)</li>
    <li><strong>recordingStartAt</strong> / <strong>recordingEndAt</strong>: Actual recording start and end timestamps</li>
    <li><strong>recordingDurationSeconds</strong>: Actual recording length in seconds</li>
    <li><strong>transcribeLocale</strong> / <strong>translateLocale</strong>: Language locales in <code>en_US</code> format</li>
    <li><strong>webUrl</strong>: Web URL to access the note.</li>
    <li><strong>collaborators</strong>: Array of collaborators with guid, name, email, and role (OWNER/EDITOR/VIEWER)</li>
    <li><strong>participants</strong>: Array of meeting participants tagged in the note, with name and email (both nullable)</li>
  </ul>;

export const NoteBaseJson = {
  guid: 'note-guid-123',
  workspaceGuid: 'ws_a1b2c3d4',
  title: 'Meeting notes',
  createdAt: '2025-07-20T10:00:00Z',
  updatedAt: '2025-07-20T11:10:00Z',
  sourceType: 'live-voice',
  recordingStartAt: '2025-07-20T10:00:10Z',
  recordingEndAt: '2025-07-20T11:00:10Z',
  recordingDurationSeconds: 3600,
  transcribeLocale: 'en_US',
  translateLocale: 'ko_KR',
  webUrl: 'https://tiro.ooo/n/123',
  collaborators: [{
    guid: 'user-guid-123',
    name: 'John Doe',
    email: 'john@example.com',
    role: 'OWNER'
  }, {
    guid: 'user-guid-456',
    name: 'Jane Smith',
    email: 'jane@example.com',
    role: 'EDITOR'
  }, {
    guid: 'user-guid-789',
    name: 'Sam',
    email: 'sam@example.com',
    role: 'VIEWER'
  }],
  participants: [{
    name: 'Alice Kim',
    email: 'alice@example.com'
  }, {
    name: 'Bob Park',
    email: null
  }]
};

## 개요

Note 리소스의 표준 스키마예요.

**중요**: Note 리소스는 회의 세부 정보, 참가자, 조직 정보를 포함한 포괄적인 메타데이터를 담고 있어요. transcript 콘텐츠와 실제 텍스트 데이터는 Note의 paragraphs endpoint를 사용해 note에 연결된 paragraphs를 가져오세요.

## 메타데이터 카테고리

Note 스키마는 여러 카테고리의 메타데이터를 포함해요:

* **Basic Information**: 제목, 타임스탬프, 소스 타입
* **Recording Details**: 시작/종료 시각, 길이, locales
* **Collaboration**: 역할과 식별자를 포함한 collaborator 정보
* **Participants**: note에 태그된 회의 참가자

## Base shape

<Json data={NoteBaseJson} />

{NoteFieldList}
