List Note Document Templates Across Workspaces

curl --request GET \
  --url https://api.tiro.ooo/v1/external/workspaces/-/note-document-templates \
  --header 'Authorization: Bearer <token>'

import requests

url = "https://api.tiro.ooo/v1/external/workspaces/-/note-document-templates"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.tiro.ooo/v1/external/workspaces/-/note-document-templates', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.tiro.ooo/v1/external/workspaces/-/note-document-templates",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.tiro.ooo/v1/external/workspaces/-/note-document-templates"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.tiro.ooo/v1/external/workspaces/-/note-document-templates")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "content": [
    {
      "id": 31,
      "title": "영업 보고서",
      "description": "영업 활동 내용을 정리하는 템플릿",
      "sections": [
        {
          "id": 41,
          "title": "영업 개요",
          "sectionType": "PLAIN_TEXT",
          "userInstruction": "영업 활동의 전반적인 내용을 요약해주세요"
        }
      ],
      "favorite": false,
      "isManaged": false,
      "isEditable": true,
      "createdAt": "2025-10-20T11:20:15Z"
    }
  ],
  "nextCursor": "cursor_string"
}

GET

external

workspaces

note-document-templates

List Note Document Templates Across Workspaces

curl --request GET \
  --url https://api.tiro.ooo/v1/external/workspaces/-/note-document-templates \
  --header 'Authorization: Bearer <token>'

import requests

url = "https://api.tiro.ooo/v1/external/workspaces/-/note-document-templates"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.tiro.ooo/v1/external/workspaces/-/note-document-templates', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.tiro.ooo/v1/external/workspaces/-/note-document-templates",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.tiro.ooo/v1/external/workspaces/-/note-document-templates"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.tiro.ooo/v1/external/workspaces/-/note-document-templates")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "content": [
    {
      "id": 31,
      "title": "영업 보고서",
      "description": "영업 활동 내용을 정리하는 템플릿",
      "sections": [
        {
          "id": 41,
          "title": "영업 개요",
          "sectionType": "PLAIN_TEXT",
          "userInstruction": "영업 활동의 전반적인 내용을 요약해주세요"
        }
      ],
      "favorite": false,
      "isManaged": false,
      "isEditable": true,
      "createdAt": "2025-10-20T11:20:15Z"
    }
  ],
  "nextCursor": "cursor_string"
}

Authorizations

Authorization

string

header

required

API key in format {id}.{secret}.

The notes an endpoint returns depend on the key type. A user key reaches the notes that user can see in the app, including notes in their own private folders. A system key (workspace or organization, no user identity) reaches only notes that sit in a folder shared with all workspace members. Notes in a private folder, in a folder shared with only some members, or in no folder at all fall outside a system key's read scope, and scopes do not widen that boundary.

List and search endpoints drop out-of-scope notes from the response without an error. Single-note reads and their sub-resources return 404, the same response as a deleted note. See What notes a system key reads.

Query Parameters

workspaceGuids

string

Optional comma-separated list of workspace GUIDs (up to 50) to restrict the result to specific workspaces. Omit to include every workspace the API key can access.

cursor

string

Cursor for the next page

size

integer

default:100

Page size (default 100, max 200)

Required range: 1 <= x <= 200

Response

Paginated list of note document templates across accessible workspaces

content

object[]

required

Array of items for current page

Show child attributes

nextCursor

string | null

required

Cursor for next page, null if last page

Example:

"opaque-cursor-string"

Home

Getting Started

API

Voice File

Webhooks

MCP

CLI

Developer Resources

List Note Document Templates Across Workspaces

Authorizations

Query Parameters

Response