v1

latestOpenAPI 3.1.02026-07-226875162.5 KB

Note

List Notes

Deprecated. Use GET /v1/external/workspaces/{workspaceGuid}/notes for workspace-scoped listing. This endpoint stays available for backward compatibility.

List notes with cursor-based pagination.

When keyword is provided the result set is reordered by full-text relevance (with createdAt desc as tiebreaker) instead of recordingStartAt desc. Keyword search requires a user-scoped API key — team-only API keys with keyword set return 400.

Use folderId to scope the listing to a specific folder (recursive, including descendant folders). Combine with createdAtFrom / createdAtTo to bound the result by creation time.

get/v1/external/notes

Query parameters

cursorstring

Cursor for the next page

sizeinteger

Page size (default 100)

keywordstring

Optional keyword. When present, results are reordered by full-text relevance and the response is bounded by what the search index returns; nextCursor is null in this mode. Requires a user-scoped API key.

folderIdstring

Restrict to notes inside a specific folder. Includes descendant folders (recursive). For a team API key, the folder must belong to the team; otherwise the call returns 404.

createdAtFromstring date-time

ISO 8601 datetime — return only notes with createdAt >= this value.

createdAtTostring date-time

ISO 8601 datetime — return only notes with createdAt < this value.

Response

List of notes

nextCursorstring nullable required

Cursor for next page, null if last page

Example response

{
  "content": [
    {
      "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"
        }
      ],
      "participants": [
        {
          "name": "Alice Kim",
          "email": "alice@example.com"
        }
      ],
      "documents": [
        {
          "id": 456,
          "noteGuid": "note-abc123-def456",
          "note": {
            "guid": "note-abc123-def456",
            "webUrl": "https://tiro.ooo/n/xQ8YKnZUPGHNB"
          },
          "template": {
            "id": 1,
            "title": "영업 보고서"
          },
          "locale": "ko_KR",
          "sections": [
            {
              "content": {
                "type": "text/plain",
                "content": "Hello everyone, welcome to today's meeting..."
              },
              "createdAt": "2025-10-20T12:35:26Z"
            }
          ],
          "createdAt": "2025-10-20T12:35:26Z",
          "updatedAt": "2025-10-20T13:45:30Z"
        }
      ]
    }
  ],
  "nextCursor": "opaque-cursor-string"
}