List Page Mentions

curl --request GET \
  --url https://api.tiro.ooo/v1/external/workspaces/{workspaceGuid}/wiki/pages/{pageGuid}/mentions \
  --header 'Authorization: Bearer <token>'

import requests

url = "https://api.tiro.ooo/v1/external/workspaces/{workspaceGuid}/wiki/pages/{pageGuid}/mentions"

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/{workspaceGuid}/wiki/pages/{pageGuid}/mentions', 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/{workspaceGuid}/wiki/pages/{pageGuid}/mentions",
  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/{workspaceGuid}/wiki/pages/{pageGuid}/mentions"

	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/{workspaceGuid}/wiki/pages/{pageGuid}/mentions")

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": [
    {
      "guid": "mention_abc123",
      "noteId": 123,
      "kind": "EXPLICIT",
      "sourceUserId": 789,
      "extractedText": "Alice Kim mentioned in our meeting",
      "createdAt": "2025-01-15T10:30:00Z",
      "paragraphId": 456,
      "paragraphUuid": "para_uuid_123",
      "confidence": 0.95
    }
  ],
  "nextCursor": "opaque-cursor-string"
}

{
  "error": {
    "code": 404018,
    "errorType": "not_found",
    "message": "No team found for user #217",
    "detail": null
  }
}

{
  "error_code": "WIKI_PLAN_REQUIRED",
  "message": "위키 기능은 Pro 이상 요금제에서 사용할 수 있어요.",
  "status_code": 402,
  "success": false,
  "current_plan": "Lite",
  "required_plans": [
    "pro",
    "max",
    "team",
    "enterprise"
  ],
  "action_url": "https://tiro.ooo/#pricing"
}

{
  "error": {
    "code": 404018,
    "errorType": "not_found",
    "message": "No team found for user #217",
    "detail": null
  }
}

GET

external

workspaces

{workspaceGuid}

wiki

pages

{pageGuid}

mentions

List Page Mentions

curl --request GET \
  --url https://api.tiro.ooo/v1/external/workspaces/{workspaceGuid}/wiki/pages/{pageGuid}/mentions \
  --header 'Authorization: Bearer <token>'

import requests

url = "https://api.tiro.ooo/v1/external/workspaces/{workspaceGuid}/wiki/pages/{pageGuid}/mentions"

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/{workspaceGuid}/wiki/pages/{pageGuid}/mentions', 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/{workspaceGuid}/wiki/pages/{pageGuid}/mentions",
  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/{workspaceGuid}/wiki/pages/{pageGuid}/mentions"

	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/{workspaceGuid}/wiki/pages/{pageGuid}/mentions")

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": [
    {
      "guid": "mention_abc123",
      "noteId": 123,
      "kind": "EXPLICIT",
      "sourceUserId": 789,
      "extractedText": "Alice Kim mentioned in our meeting",
      "createdAt": "2025-01-15T10:30:00Z",
      "paragraphId": 456,
      "paragraphUuid": "para_uuid_123",
      "confidence": 0.95
    }
  ],
  "nextCursor": "opaque-cursor-string"
}

{
  "error": {
    "code": 404018,
    "errorType": "not_found",
    "message": "No team found for user #217",
    "detail": null
  }
}

{
  "error_code": "WIKI_PLAN_REQUIRED",
  "message": "위키 기능은 Pro 이상 요금제에서 사용할 수 있어요.",
  "status_code": 402,
  "success": false,
  "current_plan": "Lite",
  "required_plans": [
    "pro",
    "max",
    "team",
    "enterprise"
  ],
  "action_url": "https://tiro.ooo/#pricing"
}

{
  "error": {
    "code": 404018,
    "errorType": "not_found",
    "message": "No team found for user #217",
    "detail": null
  }
}

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.

Path Parameters

workspaceGuid

string

required

Workspace GUID

pageGuid

string

required

Wiki page GUID

Query Parameters

cursor

string

Cursor for pagination (from nextCursor of previous response)

limit

integer

default:50

Page size (default 50, max 200)

Required range: 1 <= x <= 200

Response

Paginated list of page mentions

content

object[]

required

Array of mentions for the page

Show child attributes

nextCursor

string | null

required

Cursor for the next page of results. Null when there are no more pages.

Example:

"opaque-cursor-string"

Home

Getting Started

API

Voice File

Webhooks

MCP

CLI

Developer Resources

List Page Mentions

Authorizations

Path Parameters

Query Parameters

Response