API Overview

Use the Tiro API to read and manage notes, transcripts, summaries, and folders.

Base URL

All API requests should be made to:

https://api.tiro.ooo

Workspace access by credential type

An account API key carries the user’s identity and permissions across every workspace they can currently access. A workspace API key stays within its one workspace, while an organization API key stays within the workspaces in its organization. Call GET /v1/external/workspaces to list the workspaces the current credential can reach; each entry carries a guid, a name, and isWikiEnabled. GET /v1/external/workspaces/me returns the account API key’s default workspace or the workspace bound to a workspace API key. Workspace-scoped resources include a workspaceGuid. For example, POST /v1/external/workspaces/{workspaceGuid}/folders creates a folder in that workspace. When one account API key integrates with several workspaces, get the currently accessible workspaceGuid values from GET /v1/external/workspaces.

Rate Limits

You can send up to 600 requests per 60 seconds per API key. If you exceed that, you get a 429 response with Retry-After and X-RateLimit-* headers.

Rate Limit Exceeded

When rate limits are exceeded, you receive a 429 Too Many Requests response:

{
  "error": {
    "code": 429001,
    "message": "Rate limit exceeded. Try again in 60 seconds",
    "detail": "Limit of 600 requests per 60 seconds exceeded"
  }
}

Response Format

All API responses follow a consistent JSON format:

Success Response (List)

{
  "content": [...],
  "nextCursor": "opaque-cursor-string"
}

Success Response (Single Resource)

{
  "id": "resource-id",
  "createdAt": "2024-01-01T00:00:00Z",
  ...
}

Error Response

Errors include detailed information for debugging:

{
  "error": {
    "code": 400000,
    "message": "Human readable error message",
    "detail": null
  }
}

Home

Getting Started

API

Voice File

Webhooks

MCP

CLI

Developer Resources

Base URL

Workspace access by credential type

Rate Limits

Rate Limit Exceeded

Response Format

Success Response (List)

Success Response (Single Resource)

Error Response

​Base URL

​Workspace access by credential type

​Rate Limits

​Rate Limit Exceeded

​Response Format

​Success Response (List)

​Success Response (Single Resource)

​Error Response

Base URL

Workspace access by credential type

Rate Limits

Rate Limit Exceeded

Response Format

Success Response (List)

Success Response (Single Resource)

Error Response