Skip to main content
Use the REST API from your backend, or the MCP Server from AI clients like Claude and ChatGPT.

Get your API key

Go to the Tiro Platform API Keys page and create an account API key. It acts with your permissions across every workspace you can currently access.
2

Create an account API key

Click Create New API Key. Copy the full key including the dot — abc123.xR7mK9pL2qW4....
3

Store it

Save it as an environment variable. You can’t view it again after closing the creation dialog.
Store your API key in an environment variable. Never hardcode it or commit it.

Find your workspace

Notes live in a workspace. Call GET /v1/external/workspaces to list the workspaces you can access, and take the guid of one from the workspaces array in the response — you’ll pass it as workspaceGuid below.
GET /v1/external/notes (no workspace) is deprecated regardless of how many workspaces you have — it stays available for backward compatibility only. Always use GET /v1/external/workspaces/{workspaceGuid}/notes instead, even with a single workspace.

Make your first request

Fetch your list of notes for the workspace guid you picked in the previous step.
Tiro returns a paginated list of your notes. Each object contains the title, creation date, processing status, and a guid you use to fetch transcripts, summaries, and documents. Now that you have a list, read the Note Data Model to understand what each guid unlocks — transcripts, summaries, documents, and folders.