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"
}

인증

Authorization

string

header

필수

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.

쿼리 매개변수

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

기본값:100

Page size (default 100, max 200)

필수 범위: 1 <= x <= 200

응답

Paginated list of note document templates across accessible workspaces

content

object[]

필수

Array of items for current page

Show child attributes

nextCursor

string | null

필수

Cursor for next page, null if last page

예시:

"opaque-cursor-string"

홈

시작하기

API

음성 파일

웹훅

MCP

CLI

개발자 리소스

List Note Document Templates Across Workspaces

인증

쿼리 매개변수

응답