Get Started
API Reference
Webhooks
Template Based Documents
External Viewers
curl --request GET \
--url https://api.tiro.ooo/v1/external/notes \
--header 'Authorization: Bearer <token>'{
"content": [
{
"guid": "note-abc123-def456",
"title": "Weekly Team Meeting",
"createdAt": "2024-01-15T10:30:00Z",
"updatedAt": "2024-01-15T11:45:00Z",
"sourceType": "live-voice",
"recordingStartAt": "2024-01-15T10:30:10Z",
"recordingEndAt": "2024-01-15T11:30:15Z",
"recordingDurationSeconds": 3605,
"transcribeLocale": "ko_KR",
"translateLocale": "en_US",
"webUrl": "https://tiro.ooo/n/abc123def456",
"collaborators": [],
"participants": [
{
"name": "Alice Kim",
"email": "alice@example.com"
},
{
"name": "Bob Park",
"email": null
}
]
},
{
"guid": "note-def456-ghi789",
"title": "Product Planning Session",
"createdAt": "2024-01-14T14:00:00Z",
"updatedAt": "2024-01-14T15:30:00Z",
"sourceType": "live-voice",
"recordingStartAt": "2024-01-14T14:00:05Z",
"recordingEndAt": "2024-01-14T15:30:20Z",
"recordingDurationSeconds": 5415,
"transcribeLocale": "en_US",
"translateLocale": "ko_KR",
"webUrl": "https://tiro.ooo/n/def456ghi789",
"collaborators": [],
"participants": []
}
],
"nextCursor": "cursor_string"
}List Notes
List notes with cursor-based pagination.
When keyword is provided the result set is reordered by OpenSearch
relevance (_score desc) instead of createdAt 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.
curl --request GET \
--url https://api.tiro.ooo/v1/external/notes \
--header 'Authorization: Bearer <token>'{
"content": [
{
"guid": "note-abc123-def456",
"title": "Weekly Team Meeting",
"createdAt": "2024-01-15T10:30:00Z",
"updatedAt": "2024-01-15T11:45:00Z",
"sourceType": "live-voice",
"recordingStartAt": "2024-01-15T10:30:10Z",
"recordingEndAt": "2024-01-15T11:30:15Z",
"recordingDurationSeconds": 3605,
"transcribeLocale": "ko_KR",
"translateLocale": "en_US",
"webUrl": "https://tiro.ooo/n/abc123def456",
"collaborators": [],
"participants": [
{
"name": "Alice Kim",
"email": "alice@example.com"
},
{
"name": "Bob Park",
"email": null
}
]
},
{
"guid": "note-def456-ghi789",
"title": "Product Planning Session",
"createdAt": "2024-01-14T14:00:00Z",
"updatedAt": "2024-01-14T15:30:00Z",
"sourceType": "live-voice",
"recordingStartAt": "2024-01-14T14:00:05Z",
"recordingEndAt": "2024-01-14T15:30:20Z",
"recordingDurationSeconds": 5415,
"transcribeLocale": "en_US",
"translateLocale": "ko_KR",
"webUrl": "https://tiro.ooo/n/def456ghi789",
"collaborators": [],
"participants": []
}
],
"nextCursor": "cursor_string"
}Documentation Index
Fetch the complete documentation index at: https://api-docs.tiro.ooo/llms.txt
Use this file to discover all available pages before exploring further.
Authorizations
API key in format {id}.{secret}
Query Parameters
Cursor for the next page
Page size (default 100)
1 <= x <= 1000Optional keyword. When present, results are reordered by OpenSearch
relevance and the response is bounded by what the search index
returns; nextCursor is null in this mode. Requires a
user-scoped API key.
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.
ISO 8601 datetime — return only notes with createdAt >= this value.
ISO 8601 datetime — return only notes with createdAt < this value.