---
title: "Discover Templates"
method: GET
path: "/api/bitable-templates/discover"
tags: ["bitable-templates"]
---

# Discover Templates

`GET /api/bitable-templates/discover`

## Request

- Base URL: `https://api.tintin-x.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.tintin-x.com/api/bitable-templates/discover`
- Auth: HTTP bearer

Semantic template search via pgvector cosine similarity.

`scope="team"` (default): own + team + null-owner only. The
`bittable-planner` skill defaults here so a noisy short query
can't snipe a stranger's `is_listed=True` template — the failure
mode that anchored an unrelated `四则运算计算器` calculator template
into a Media Creator's chat (gamma 2026-04-29).

`scope="all"`: also include `is_listed=True` from any team. Used
by the public templates library UI where browsing across teams is
the explicit user intent.

Falls back to ILIKE when embeddings are unavailable (openai key
missing, embedding on the template failed at capture, etc.).

## Query parameters

- `query` string, required
- `limit` integer
- `scope` string

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/tintin-x/apis/tintin-api.md) · [All operations](https://skmtc.dev/tintin-x/apis/tintin-api/llms.txt) · [OpenAPI document](https://skmtc.dev/tintin-x/apis/tintin-api/revisions/8839a8d0a66c?raw)