Skip to main content
Tiro API에서 노트, 전사, 요약, 폴더를 조회하고 관리해요.

Base URL

모든 API 요청은 다음 주소로 보내세요.

자격 증명별 워크스페이스 접근 범위

계정 API Key는 사용자 신원으로 동작하며, 그 사용자가 현재 접근할 수 있는 모든 워크스페이스의 리소스에 사용자와 같은 권한으로 접근해요. 워크스페이스 API Key는 연결된 워크스페이스 하나, 조직 API Key는 조직에 속한 워크스페이스에 한정돼요. GET /v1/external/workspaces를 호출하면 현재 자격 증명이 접근할 수 있는 워크스페이스 목록을 받아요. 각 항목에는 guid, name, isWikiEnabled가 담겨 있어요. GET /v1/external/workspaces/me는 계정 API Key의 기본 워크스페이스 또는 워크스페이스 API Key가 연결된 워크스페이스를 반환해요. 워크스페이스 단위 리소스는 workspaceGuid를 포함해요. 예를 들어 POST /v1/external/workspaces/{workspaceGuid}/folders는 해당 워크스페이스에 폴더를 만들어요. 계정 API Key 하나로 여러 워크스페이스를 연동할 때는 GET /v1/external/workspaces에서 현재 접근 가능한 workspaceGuid를 확인하세요.

Rate Limit

API Key 하나당 60초에 600개 요청을 보낼 수 있어요. 초과하면 429 응답과 Retry-After·X-RateLimit-* 헤더를 받아요.

Rate Limit 초과

rate limit을 초과하면 429 Too Many Requests 응답을 받아요.

응답 형식

모든 API 응답은 일관된 JSON 형식을 따라요.

성공 응답 (목록)

성공 응답 (단일 리소스)

에러 응답

에러에는 디버깅에 도움이 되는 상세 정보가 포함돼요.