Skip to main content

​
Overview

Standard schema for the Note resource. Important: Note resources contain comprehensive metadata including meeting details, participants, and organizational information. For transcript content and actual text data, use the Note’s paragraphs endpoint to retrieve paragraphs associated with the note.

​
Metadata Categories

The Note schema includes several categories of metadata:
  • Basic Information: Title, timestamps, source type
  • Recording Details: Start/end times, duration, locales
  • Collaboration: Collaborator information with roles and identifiers
  • Participants: Meeting participants tagged in the note

​
Base shape

{
  "guid": "note-guid-123",
  "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",
  "web_url": "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
    }
  ]
}