Skip to main content

​
Welcome to the Tiro API

The Tiro API enables developers to integrate AI-powered note-taking capabilities into their applications. Our API provides endpoints for managing notes and processing voice files with automatic transcription and translation.

​
Base URL

All API requests should be made to: 
https://api.tiro.ooo

​
Rate Limits

To ensure fair usage and system stability, the Tiro API implements the following rate limits:

​
Rate Limit Exceeded

When rate limits are exceeded, you’ll receive a 429 Too Many Requests response: 
{
  "error": {
    "code": 429001,
    "message": "Rate limit exceeded. Try again in 3600 seconds",
    "detail": "Hourly limit of 1000 requests 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
  }
}