Skip to main content
POST
/
v1
/
external
/
notes
/
search
curl --request POST \
  --url https://api.tiro.ooo/v1/external/notes/search \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "keyword": "OKR"
}
'
{
  "notes": [
    {
      "guid": "note-abc123-def456",
      "title": "OKR Q2 Planning",
      "createdAt": "2026-04-15T10:00:00Z",
      "updatedAt": "2026-04-15T11:30:00Z",
      "sourceType": "live-voice",
      "recordingStartAt": "2026-04-15T10:00:05Z",
      "recordingEndAt": "2026-04-15T11:00:30Z",
      "recordingDurationSeconds": 3625,
      "transcribeLocale": "ko_KR",
      "translateLocale": null,
      "webUrl": "https://tiro.ooo/n/abc123def456",
      "collaborators": [],
      "participants": [
        {
          "name": "Alice Kim",
          "email": "alice@example.com"
        }
      ],
      "matchedSnippets": null,
      "documents": []
    }
  ],
  "nextCursor": null,
  "degraded": false
}

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

​
Authorization
string
header
required

API key in format {id}.{secret}

Body

application/json
​
keyword
string
required

Search keyword. Matched against note title and paragraph content via OpenSearch.

Minimum string length: 1
Example:

"OKR"

​
filter
object
​
pagination
object

Response

Matched notes with their documents.

​
notes
object[]
required

Matched notes, ordered by OpenSearch relevance.

​
nextCursor
string | null
​
degraded
boolean
default:false

true when the response was produced via a fallback path (e.g., OpenSearch unavailable). When degraded, notes may be empty and quality is reduced.

​
degradedReason
enum<string> | null

Machine-readable reason when degraded=true. null otherwise.

Available options:
search_index_unavailable,
search_index_degraded,
null