# Tiro Docs: English Developer Docs ## Developer Docs ### Home - [Tiro Developer Docs](https://docs.tiro.ooo/en/developers/index.md): How to integrate with Tiro through the REST API, Webhooks, MCP, and CLI. ### Getting Started - [Quickstart](https://docs.tiro.ooo/en/developers/getting-started/quickstart.md): How to create an API key and send your first Tiro API request. ### API - [API Overview](https://docs.tiro.ooo/en/developers/fundamentals/api-overview.md): Base URL, credential access boundaries, rate limits, and response format for the Tiro API. - [Authentication](https://docs.tiro.ooo/en/developers/fundamentals/authentication.md): API key types, how to authenticate, and what scopes control. - [Build consent-based integrations with OAuth](https://docs.tiro.ooo/en/developers/fundamentals/oauth.md): An OAuth 2.0 integration that lets your internal systems reach a member's Tiro notes after a single consent, with no API key to issue. - [What notes a system API key reads](https://docs.tiro.ooo/en/developers/fundamentals/system-key-note-scope.md): System API keys and system webhooks reach only notes in folders shared with all workspace members. See the boundary for each credential type. - [Integrate at the organization level](https://docs.tiro.ooo/en/developers/organization/org-integration.md): Manage notes, workspaces, members, and sessions with an organization API key. - [Error Handling](https://docs.tiro.ooo/en/developers/fundamentals/error-handling.md): Error response format and status codes for the Tiro API. - [Note Data Model](https://docs.tiro.ooo/en/developers/fundamentals/note-data-model.md): How Note, Paragraph, NoteSummary, and NoteDocument relate, and which API to call. - [Note](https://docs.tiro.ooo/en/developers/schemas/note.md): Fields and metadata of the Note resource. #### Template Documents - [Summary And Document](https://docs.tiro.ooo/en/developers/template-based-documents/summary-and-document.md): How NoteDocument and NoteSummary differ, and what the API supports. #### API Reference ##### Workspace - [List Workspaces](https://docs.tiro.ooo/api-reference/workspace/list-workspaces.md): List all workspaces accessible to the caller's API key or OAuth token. - [Get My Workspace](https://docs.tiro.ooo/api-reference/workspace/get-my-workspace.md): **Deprecated.** Use `GET /v1/external/workspaces` and pass the chosen `guid` explicitly. This endpoint stays available for backward compatibility. ##### Note - [List Notes](https://docs.tiro.ooo/api-reference/note/list-notes.md): **Deprecated.** Use `GET /v1/external/workspaces/{workspaceGuid}/notes` for workspace-scoped listing. This endpoint stays available for backward compatibility. - [List Workspace Notes](https://docs.tiro.ooo/api-reference/note/list-workspace-notes.md): List the notes in a workspace with cursor-based pagination. This is the workspace-scoped successor to the deprecated `GET /v1/external/notes`. - [Search Workspace Notes (Deep)](https://docs.tiro.ooo/api-reference/note/search-workspace-notes-deep.md): Deep keyword search scoped to one workspace, named in the path by `workspaceGuid`. Returns notes hydrated with their primary documents (one-pager, custom) so an MCP/LLM client can read content alongside metadata in a single call. This is the workspace-scoped successor to the deprecated `POST /v1/ext… - [Search Notes (Deep)](https://docs.tiro.ooo/api-reference/note/search-notes-deep.md): **Deprecated.** Use `POST /v1/external/workspaces/{workspaceGuid}/notes/search` for workspace-scoped deep search, which also accepts workspace-system and team API keys. This endpoint stays available for backward compatibility. - [Reserve Note GUID](https://docs.tiro.ooo/api-reference/note/reserve-note-guid.md): Reserve a note GUID for later use in note creation. This allows you to: - Get a GUID before actually creating the note - Use the reserved GUID when creating a note with POST /v1/notes (internal API) - Reservation expires after 1 hour if not used - [Get Note](https://docs.tiro.ooo/api-reference/note/get-note.md): Retrieve a single note by its GUID - [Update Note](https://docs.tiro.ooo/api-reference/note/update-note.md): Update a note's metadata (partial update). Currently only the note `title` can be changed. Requires the `note:write` scope. - [Reset Paragraph Contents (Dev Only)](https://docs.tiro.ooo/api-reference/note/reset-paragraph-contents-dev-only.md): Resets one content kind across every paragraph in a note atomically. This endpoint is available only when content editing is enabled in the environment. It is being tested in dev and is not available in production. Requires `note:write` and permission to edit the note. - [List Note Paragraphs](https://docs.tiro.ooo/api-reference/note/list-note-paragraphs.md): Returns a note's transcript as paragraphs — the "conversation notes" / transcript content (a speaker turn or topic chunk per paragraph). ##### Note Share Link - [Get Share Link](https://docs.tiro.ooo/api-reference/note-share-link/get-share-link.md): Retrieve the current share link for a note. - [Upsert Share Link](https://docs.tiro.ooo/api-reference/note-share-link/upsert-share-link.md): Create or update a share link for a note. - [Delete Share Link](https://docs.tiro.ooo/api-reference/note-share-link/delete-share-link.md): Delete the share link for a note. ##### Folder - [List Folders](https://docs.tiro.ooo/api-reference/folder/list-folders.md): List the folders you can access in a workspace, as a flat array. - [Create Folder](https://docs.tiro.ooo/api-reference/folder/create-folder.md): Create a folder in a workspace. - [Get Folder Tree](https://docs.tiro.ooo/api-reference/folder/get-folder-tree.md): Retrieve the workspace folder hierarchy as a nested tree. - [Get Folder](https://docs.tiro.ooo/api-reference/folder/get-folder.md): Retrieve a single folder by ID. The workspace is resolved from the folder, so no workspace is needed in the path. - [Delete Folder](https://docs.tiro.ooo/api-reference/folder/delete-folder.md): Delete a folder. The folder must have no subfolders — delete or move its children first. Requires edit access. - [Update Folder](https://docs.tiro.ooo/api-reference/folder/update-folder.md): Update a folder's title, description, color, or sharing type (partial update). Requires edit access. - [Get Folder Path](https://docs.tiro.ooo/api-reference/folder/get-folder-path.md): Retrieve the breadcrumb path from the root to the folder, inclusive. The first element is the top-level ancestor and the last element is the folder itself. - [Move Folder](https://docs.tiro.ooo/api-reference/folder/move-folder.md): Move a folder under a new parent, or to the root level with `newParentId: null`. The target parent must be in the same workspace and you must have access to it. You cannot move a folder into its own subtree. - [Reorder Folders](https://docs.tiro.ooo/api-reference/folder/reorder-folders.md): Set the display order of sibling folders. Provide every sibling's ID in the desired order; positions are assigned by array index. The workspace is inferred from the first folder ID. - [Attach Note to Folder](https://docs.tiro.ooo/api-reference/folder/attach-note-to-folder.md): Add an existing note to the folder. The note must belong to the same workspace as the folder. Requires edit access to the folder. - [Detach Note from Folder](https://docs.tiro.ooo/api-reference/folder/detach-note-from-folder.md): Remove a note from the folder. This does not delete the note itself. Requires edit access to the folder. - [List Folders by Note](https://docs.tiro.ooo/api-reference/folder/list-folders-by-note.md): Retrieve folders for a specific note ##### Voice File - [Create Voice File Job](https://docs.tiro.ooo/api-reference/voice-file/create-voice-file-job.md): Create a new Voice File Job for audio transcription and optional translation. - [Notify Upload Complete](https://docs.tiro.ooo/api-reference/voice-file/notify-upload-complete.md): Notify that audio file upload is complete and start processing. - [Get Voice File Job](https://docs.tiro.ooo/api-reference/voice-file/get-voice-file-job.md): Retrieve the current status and details of a Voice File Job. - [Delete Voice File Job](https://docs.tiro.ooo/api-reference/voice-file/delete-voice-file-job.md): Delete a Voice File Job in any status, including while processing. - [Get Transcript](https://docs.tiro.ooo/api-reference/voice-file/get-transcript.md): Retrieve the transcribed text from a completed Voice File Job. - [List Translations](https://docs.tiro.ooo/api-reference/voice-file/list-translations.md): List all translations generated for a Voice File Job. - [Get Translation](https://docs.tiro.ooo/api-reference/voice-file/get-translation.md): Retrieve a specific translation by locale. - [Get Transcript Paragraph Summary](https://docs.tiro.ooo/api-reference/voice-file/get-transcript-paragraph-summary.md): Retrieve AI-generated paragraph summaries from the transcript. - [Get Translation Paragraph Summary](https://docs.tiro.ooo/api-reference/voice-file/get-translation-paragraph-summary.md): Retrieve AI-generated paragraph summaries from a translated version. ##### Note Document - [List Note Documents](https://docs.tiro.ooo/api-reference/note-document/list-note-documents.md): List all documents generated for a specific note. - [Generate Note Document](https://docs.tiro.ooo/api-reference/note-document/generate-note-document.md): Generate a note document based on a template. - [Get Note Document](https://docs.tiro.ooo/api-reference/note-document/get-note-document.md): Retrieve a specific note document by ID. ##### Note Summary - [List Note Summaries](https://docs.tiro.ooo/api-reference/note-summary/list-note-summaries.md): List all summaries generated for a specific note. - [Get Note Summary](https://docs.tiro.ooo/api-reference/note-summary/get-note-summary.md): Retrieve a specific summary with full content. ##### Note Document Template - [List Note Document Templates](https://docs.tiro.ooo/api-reference/note-document-template/list-note-document-templates.md): Deprecated. Use the path-explicit list endpoints (users/me, workspaces, organizations/me). Resolves scope by API key type. - [List Managed Note Document Templates](https://docs.tiro.ooo/api-reference/note-document-template/list-managed-note-document-templates.md): List Tiro's built-in (managed) note document templates, with cursor-based pagination. Managed templates are curated by Tiro and shared across every account; they are read-only (`isManaged: true`, `isEditable: false`). - [List User Note Document Templates](https://docs.tiro.ooo/api-reference/note-document-template/list-user-note-document-templates.md): List the calling user's personal note document templates, with cursor-based pagination. Only templates the user owns personally are returned — workspace and organization templates are excluded. - [List Bound Workspace Note Document Templates](https://docs.tiro.ooo/api-reference/note-document-template/list-bound-workspace-note-document-templates.md): List the note document templates in the workspace bound to the API key, with cursor-based pagination. Use this with a workspace-scoped key when you do not want to pass the workspace GUID explicitly. A key that is not bound to a workspace gets `403`. - [List Workspace Note Document Templates](https://docs.tiro.ooo/api-reference/note-document-template/list-workspace-note-document-templates.md): List the note document templates in the specified workspace, with cursor-based pagination. The API key must be able to access the workspace in the path; a key bound to a different workspace returns `403`. - [List Note Document Templates Across Workspaces](https://docs.tiro.ooo/api-reference/note-document-template/list-note-document-templates-across-workspaces.md): List note document templates across every workspace the API key can access, with cursor-based pagination. Pass the optional `workspaceGuids` query parameter (comma-separated, up to 50 GUIDs) to restrict the result to specific workspaces; omit it to include every accessible workspace. - [List Organization Note Document Templates](https://docs.tiro.ooo/api-reference/note-document-template/list-organization-note-document-templates.md): List the org-owned note document templates of the organization bound to the API key, with cursor-based pagination. Requires an organization API key; personal, workspace, and legacy team keys return `401`. - [Get Note Document Template](https://docs.tiro.ooo/api-reference/note-document-template/get-note-document-template.md): Retrieve a specific note document template by ID. ##### Word Memory - [List User Word Memories](https://docs.tiro.ooo/api-reference/word-memory/list-user-word-memories.md): Retrieve user word memories with cursor-based pagination. - [Create User Word Memory](https://docs.tiro.ooo/api-reference/word-memory/create-user-word-memory.md): Register a new word to the user's personal word memory. - [Bulk Create User Word Memories](https://docs.tiro.ooo/api-reference/word-memory/bulk-create-user-word-memories.md): Create multiple word memories in one request (up to 1000). Duplicate `(entry, subEntry)` pairs — against both existing entries and other items in the same request — are silently skipped, so the response contains only the newly created entries. Safe to re-run (idempotent). - [Bulk Update User Word Memories](https://docs.tiro.ooo/api-reference/word-memory/bulk-update-user-word-memories.md): Update multiple word memories in one request (up to 1000). Processed atomically — if any `id` is not found (`404`) or an update would create a duplicate (`409`), the entire batch is rolled back. - [Bulk Delete User Word Memories](https://docs.tiro.ooo/api-reference/word-memory/bulk-delete-user-word-memories.md): Delete multiple word memories by ID (up to 1000). Non-existent or non-owned IDs are ignored; the response reports how many were actually deleted. - [Get User Word Memory](https://docs.tiro.ooo/api-reference/word-memory/get-user-word-memory.md): Retrieve a specific word memory by ID - [Delete User Word Memory](https://docs.tiro.ooo/api-reference/word-memory/delete-user-word-memory.md): Delete a word memory. This action is irreversible. - [Update User Word Memory](https://docs.tiro.ooo/api-reference/word-memory/update-user-word-memory.md): Update an existing word memory. - [List Workspace Word Memories](https://docs.tiro.ooo/api-reference/word-memory/list-workspace-word-memories.md): List a workspace's shared word memories with cursor-based pagination. Name the target workspace in the path with its `workspaceGuid` — obtain it from `GET /v1/external/workspaces`. - [Create Workspace Word Memory](https://docs.tiro.ooo/api-reference/word-memory/create-workspace-word-memory.md): Register a new word to a workspace's shared word memory. Name the target workspace in the path with its `workspaceGuid`. - [Bulk Create Workspace Word Memories](https://docs.tiro.ooo/api-reference/word-memory/bulk-create-workspace-word-memories.md): Create multiple word memories in a workspace in one request (up to 1000). Duplicate `(entry, subEntry)` pairs are silently skipped, so the response contains only the newly created entries. Requires a **user** API key that is a writable member of the workspace; a workspace-bound key must match the pa… - [Bulk Update Workspace Word Memories](https://docs.tiro.ooo/api-reference/word-memory/bulk-update-workspace-word-memories.md): Update multiple workspace word memories in one request (up to 1000). Processed atomically — if any `id` is not found (`404`) or an update would create a duplicate (`409`), the entire batch is rolled back. Requires a **user** API key that is a writable member of the workspace. - [Bulk Delete Workspace Word Memories](https://docs.tiro.ooo/api-reference/word-memory/bulk-delete-workspace-word-memories.md): Delete multiple workspace word memories by ID (up to 1000). Non-existent IDs are ignored; the response reports how many were actually deleted. Requires a **user** API key that is a writable member of the workspace. - [Get Workspace Word Memory](https://docs.tiro.ooo/api-reference/word-memory/get-workspace-word-memory.md): Retrieve a specific workspace word memory by ID. - [Delete Workspace Word Memory](https://docs.tiro.ooo/api-reference/word-memory/delete-workspace-word-memory.md): Delete a workspace word memory. This action is irreversible. Once deleted, Tiro no longer references this word during transcription for any workspace member. - [Update Workspace Word Memory](https://docs.tiro.ooo/api-reference/word-memory/update-workspace-word-memory.md): Update an existing workspace word memory. Only provided fields are updated (partial update). - [List Organization Word Memories](https://docs.tiro.ooo/api-reference/word-memory/list-organization-word-memories.md): List the organization's shared word memories with cursor-based pagination. These are shared across every workspace in the organization. - [Create Organization Word Memory](https://docs.tiro.ooo/api-reference/word-memory/create-organization-word-memory.md): Register a new word to the organization's shared word memory. Requires an **organization** API key. - [Bulk Create Organization Word Memories](https://docs.tiro.ooo/api-reference/word-memory/bulk-create-organization-word-memories.md): Create multiple organization word memories in one request (up to 1000). Duplicate `(entry, subEntry)` pairs are silently skipped, so the response contains only the newly created entries. Safe to re-run (idempotent). Requires an **organization** API key. - [Bulk Update Organization Word Memories](https://docs.tiro.ooo/api-reference/word-memory/bulk-update-organization-word-memories.md): Update multiple organization word memories in one request (up to 1000). Processed atomically — if any `id` is not found (`404`) or an update would create a duplicate (`409`), the entire batch is rolled back. Requires an **organization** API key. - [Bulk Delete Organization Word Memories](https://docs.tiro.ooo/api-reference/word-memory/bulk-delete-organization-word-memories.md): Delete multiple organization word memories by ID (up to 1000). Non-existent IDs are ignored; the response reports how many were actually deleted. Requires an **organization** API key. - [Get Organization Word Memory](https://docs.tiro.ooo/api-reference/word-memory/get-organization-word-memory.md): Retrieve a specific organization word memory by ID. Requires an **organization** API key. - [Delete Organization Word Memory](https://docs.tiro.ooo/api-reference/word-memory/delete-organization-word-memory.md): Delete an organization word memory. This action is irreversible. Requires an **organization** API key. - [Update Organization Word Memory](https://docs.tiro.ooo/api-reference/word-memory/update-organization-word-memory.md): Update an existing organization word memory. Only provided fields are updated (partial update). Requires an **organization** API key. ##### Organization - [Get My Organization](https://docs.tiro.ooo/api-reference/organization/get-my-organization.md): Retrieve the organization bound to the caller's API key. Requires an organization API key — keys issued by an organization admin from the organization console. Personal, workspace, and legacy team keys return `401`. - [List Organization Members](https://docs.tiro.ooo/api-reference/organization/list-organization-members.md): List existing organization members. This endpoint does not create or invite users. - [Get Organization Member](https://docs.tiro.ooo/api-reference/organization/get-organization-member.md) - [Suspend Member Recording](https://docs.tiro.ooo/api-reference/organization/suspend-member-recording.md): Idempotently prevent the organization member from starting recordings. - [Resume Member Recording](https://docs.tiro.ooo/api-reference/organization/resume-member-recording.md): Idempotently remove the member's recording suspension. - [Revoke All Member Sessions](https://docs.tiro.ooo/api-reference/organization/revoke-all-member-sessions.md): Revoke every current Tiro session for an existing organization member. The user can sign in again unless access is blocked by the identity provider. - [Add or Update Workspace Member](https://docs.tiro.ooo/api-reference/organization/add-or-update-workspace-member.md): Idempotently assign an existing organization member to an organization workspace, or update that workspace role. This endpoint does not create or invite users. - [Remove Workspace Member](https://docs.tiro.ooo/api-reference/organization/remove-workspace-member.md): Idempotently remove an existing organization member from an organization workspace. - [List Organization Notes](https://docs.tiro.ooo/api-reference/organization/list-organization-notes.md): List ended notes in the workspaces of the organization bound to the API key, with cursor-based pagination. A note is "ended" when its recording has finished (`recordingEndAt` is set) — the same condition that fires the `note.ended` webhook event. ##### Wiki - [Get Wiki Info](https://docs.tiro.ooo/api-reference/wiki/get-wiki-info.md): Retrieve metadata for the workspace's wiki (name, creation timestamp, etc.). - [List Wiki Pages](https://docs.tiro.ooo/api-reference/wiki/list-wiki-pages.md): List wiki pages with cursor-based pagination. Optionally filter by page type or creation date, or search by keyword (which reorders results by relevance and disables cursor pagination). - [Get Wiki Page Details](https://docs.tiro.ooo/api-reference/wiki/get-wiki-page-details.md): Retrieve full details for a wiki page, including body/description, mentions, aliases, and links. - [List Page Mentions](https://docs.tiro.ooo/api-reference/wiki/list-page-mentions.md): List mentions (references from notes) for a specific wiki page with cursor-based pagination. - [Search Wiki Pages](https://docs.tiro.ooo/api-reference/wiki/search-wiki-pages.md): Keyword-required search for wiki pages. Returns pages ranked by full-text relevance. - [Search Wiki Mentions](https://docs.tiro.ooo/api-reference/wiki/search-wiki-mentions.md): Keyword-required search for mentions (references in notes). Returns ranked mentions with source context. - [Get Wiki Graph Seed](https://docs.tiro.ooo/api-reference/wiki/get-wiki-graph-seed.md): Retrieve an initial set of nodes and edges for graph visualization. Optionally filter by page type, creation date, or search keyword. - [Expand Wiki Graph](https://docs.tiro.ooo/api-reference/wiki/expand-wiki-graph.md): Expand the graph around a specific wiki page by traversing links up to a given depth. - [Get Wiki Graph Around](https://docs.tiro.ooo/api-reference/wiki/get-wiki-graph-around.md): Retrieve the graph in the neighborhood of a wiki page (radius-based expansion). - [Get Wiki Graph Links](https://docs.tiro.ooo/api-reference/wiki/get-wiki-graph-links.md): Retrieve the graph of links between multiple wiki pages. Pass one or more page GUIDs as repeated `pageGuids` query parameters. ### Voice File - [Overview](https://docs.tiro.ooo/en/developers/voice-file/overview.md): How to create a Voice File Job, upload audio, check status, and retrieve or delete results. - [Tutorial](https://docs.tiro.ooo/en/developers/voice-file/tutorial.md): Step-by-step guide to process audio files with transcription and translation ### Webhooks - [Webhooks Overview](https://docs.tiro.ooo/en/developers/webhooks/webhooks-overview.md): How to set up and verify webhooks that deliver note, summary, document, and voice file job events over HTTP POST. - [Best Practices](https://docs.tiro.ooo/en/developers/webhooks/best-practices.md): Best practices for handling webhook events #### Events - [Event Structure](https://docs.tiro.ooo/en/developers/webhooks/events/schema.md): Review the common Tiro webhook payload, supported event types, resource mappings, and implementation details for reliable event handling. - [Note Events](https://docs.tiro.ooo/en/developers/webhooks/events/note-events.md): Webhook events for Note resources - [Note Document Events](https://docs.tiro.ooo/en/developers/webhooks/events/note-document-events.md): Webhook events for NoteDocument resources - [Note Summary Events](https://docs.tiro.ooo/en/developers/webhooks/events/note-summary-events.md): Webhook events for NoteSummary resources - [FolderNote Events](https://docs.tiro.ooo/en/developers/webhooks/events/folder-note-events.md): Webhook events for FolderNoteRelation resources ### MCP - [MCP Overview](https://docs.tiro.ooo/en/developers/mcp/mcp-overview.md): An MCP server for searching and reading Tiro notes from an AI client. - [Install Tiro MCP in your agent](https://docs.tiro.ooo/en/developers/mcp/install.md): A prompt that tells your agent to connect and authenticate the Tiro MCP server. - [Connect your client](https://docs.tiro.ooo/en/developers/mcp/setup.md): How to connect the Tiro MCP server in Claude (web, Desktop, Code), ChatGPT, Codex, and Cursor. - [MCP Use Cases](https://docs.tiro.ooo/en/developers/mcp/use-cases.md): Workflows for finding notes and reading their content with Tiro MCP. - [Troubleshooting](https://docs.tiro.ooo/en/developers/mcp/troubleshooting.md): How to fix Tiro MCP connection, authentication, and search problems. - [Edit Notes & Folders (Discontinued)](https://docs.tiro.ooo/en/developers/mcp/tools/edit-notes-folders.md): Note/folder edit tools were removed — see the replacement paths. #### Tools - [Tools](https://docs.tiro.ooo/en/developers/mcp/tools/overview.md): The tools available through Tiro MCP. - [list_workspaces](https://docs.tiro.ooo/en/developers/mcp/tools/list-workspaces.md): List the workspaces your API Key can access and each workspace's GUID. Get the workspaceGuid you pass to other tools here. - [list_notes](https://docs.tiro.ooo/en/developers/mcp/tools/list-notes.md): Retrieve note metadata by filter and keyword. - [search_notes](https://docs.tiro.ooo/en/developers/mcp/tools/search-notes.md): Search notes and their primary documents by keyword. - [get_note](https://docs.tiro.ooo/en/developers/mcp/tools/get-note.md): Retrieve note metadata together with its summary, transcript, and documents. - [get_note_transcript](https://docs.tiro.ooo/en/developers/mcp/tools/get-transcript.md): Retrieve the full transcript and speaker information of a meeting note. - [Get Note Folders](https://docs.tiro.ooo/en/developers/mcp/tools/get-note-folders.md): Find the folders a note belongs to, by note GUID. - [Folder Search](https://docs.tiro.ooo/en/developers/mcp/tools/folder-search.md): Search private and workspace folders by name. - [Share Links](https://docs.tiro.ooo/en/developers/mcp/tools/share-links.md): Retrieve a note's public share link. - [Wiki](https://docs.tiro.ooo/en/developers/mcp/tools/wiki.md): Search, read, and traverse the workspace wiki. - [auth_status](https://docs.tiro.ooo/en/developers/mcp/tools/auth-status.md): Check current authentication status and permissions ### CLI - [CLI Overview](https://docs.tiro.ooo/en/developers/cli/cli-overview.md): A CLI for working with Tiro notes and transcripts from a shell, CI, or an agent. - [Quickstart](https://docs.tiro.ooo/en/developers/cli/quickstart.md): Examples for listing notes, searching, saving to files, and piping to a shell. - [Install & authenticate](https://docs.tiro.ooo/en/developers/cli/setup.md): Install the Tiro CLI, sign in with OAuth, and set up headless or CI authentication. - [Install the Tiro CLI in your agent](https://docs.tiro.ooo/en/developers/cli/install.md): A prompt that tells your agent to install the Tiro CLI and sign you in. - [For AI agents](https://docs.tiro.ooo/en/developers/cli/agent-guide.md): How to choose between MCP and the CLI for agent work, with examples. ### Developer Resources - [Glossary](https://docs.tiro.ooo/en/developers/resources/glossary.md): Terms that differ between the Tiro app and the API. - [Usage Policy & Pricing](https://docs.tiro.ooo/en/developers/resources/usage-policy.md): Authentication, pricing, and rate limits for the REST API, MCP, and CLI. - [Supported Locales](https://docs.tiro.ooo/en/developers/fundamentals/supported-locales.md): Locales used for transcription, translation, and summaries - [External Viewers](https://docs.tiro.ooo/en/developers/reference/external-viewers.md): View the Tiro OpenAPI spec in Redoc or Swagger, or download it. ## OpenAPI Specs - [openapi](/openapi.yaml)