List Note Paragraphs

curl --request GET \
  --url https://api.tiro.ooo/v1/external/notes/{noteGuid}/paragraphs \
  --header 'Authorization: Bearer <token>'

{
  "content": [
    {
      "uuid": "para-1",
      "transcribeLocale": "en_US",
      "transcript": {
        "type": "text/plain",
        "content": "Hello everyone..."
      },
      "translateLocale": "ko_KR",
      "translated": {
        "type": "text/plain",
        "content": "여러분 안녕하세요..."
      },
      "summaryLocale": "en_US",
      "summary": {
        "type": "text/markdown",
        "content": "- Greeting and agenda..."
      },
      "timeFrom": "2025-07-20T10:00:10Z",
      "timeTo": "2025-07-20T10:00:25Z",
      "locked": false
    }
  ],
  "nextCursor": "opaque-cursor-string"
}

GET

external

notes

{noteGuid}

paragraphs

List Note Paragraphs

curl --request GET \
  --url https://api.tiro.ooo/v1/external/notes/{noteGuid}/paragraphs \
  --header 'Authorization: Bearer <token>'

{
  "content": [
    {
      "uuid": "para-1",
      "transcribeLocale": "en_US",
      "transcript": {
        "type": "text/plain",
        "content": "Hello everyone..."
      },
      "translateLocale": "ko_KR",
      "translated": {
        "type": "text/plain",
        "content": "여러분 안녕하세요..."
      },
      "summaryLocale": "en_US",
      "summary": {
        "type": "text/markdown",
        "content": "- Greeting and agenda..."
      },
      "timeFrom": "2025-07-20T10:00:10Z",
      "timeTo": "2025-07-20T10:00:25Z",
      "locked": false
    }
  ],
  "nextCursor": "opaque-cursor-string"
}

Authorizations

Authorization

string

header

required

API key in format {id}.{secret}

Path Parameters

noteGuid

string

required

Note GUID

Query Parameters

cursor

string

Cursor for the next page

size

integer

default:100

Page size (default 100)

Required range: 1 <= x <= 1000

Response

List of paragraphs

content

object[]

required

Array of items for current page

Show child attributes

content.uuid

string

required

Unique identifier for the paragraph

Example:

"para-1"

content.transcribeLocale

string

Locale used for transcription

Example:

"en_US"

content.transcript

object

Show child attributes

content.transcript.type

enum<string>

required

MIME type of the text content

Available options:

text/plain,

text/markdown,

text/html

Example:

"text/plain"

content.transcript.content

string

required

The actual text content

Example:

"Hello everyone, welcome to today's meeting..."

Example:

{
  "type": "text/plain",
  "content": "Hello everyone..."
}

content.translateLocale

string

Locale used for translation

Example:

"ko_KR"

content.translated

object

Show child attributes

content.translated.type

enum<string>

required

MIME type of the text content

Available options:

text/plain,

text/markdown,

text/html

Example:

"text/plain"

content.translated.content

string

required

The actual text content

Example:

"Hello everyone, welcome to today's meeting..."

Example:

{
  "type": "text/plain",
  "content": "여러분 안녕하세요..."
}

content.summaryLocale

string

Locale used for summary

Example:

"en_US"

content.summary

object

Show child attributes

content.summary.type

enum<string>

required

MIME type of the text content

Available options:

text/plain,

text/markdown,

text/html

Example:

"text/plain"

content.summary.content

string

required

The actual text content

Example:

"Hello everyone, welcome to today's meeting..."

Example:

{
  "type": "text/markdown",
  "content": "- Greeting and agenda..."
}

content.timeFrom

string<date-time>

Start time of the paragraph

Example:

"2025-07-20T10:00:10Z"

content.timeTo

string<date-time>

End time of the paragraph

Example:

"2025-07-20T10:00:25Z"

content.locked

boolean

Whether the paragraph is locked for editing

Example:

false

nextCursor

string | null

required

Cursor for next page, null if last page

Example:

"opaque-cursor-string"

Get Note

List User Folders

⌘I

Getting Started

Fundamentals

Webhooks

Voice File

Template Based Documents

API Reference

MCP Server

External Viewers

List Note Paragraphs

Authorizations

Path Parameters

Query Parameters

Response