Tana Documentation API
Public, unauthenticated agent-native documentation API: index, search, and read Tana and Tana Outliner docs as clean markdown.
OpenAPI Specification
openapi: 3.1.0
info:
title: Tana Documentation AddToNodeV2 Docs API
version: '1.0'
description: 'A public, unauthenticated agent-native documentation API for Tana. It lets an agent or client discover Tana''s documentation programmatically: fetch the full index (feature taxonomy, section outlines, descriptions), search documentation by text pattern scoped to feature areas, and read a full page or a specific section as clean markdown. Covers both the Tana agentic meeting platform (product `tana`) and Tana Outliner (product `outliner`). The service is self-describing at https://tana.inc/api/docs and anchored by an llms.txt index.'
contact:
name: Tana
url: https://tana.inc/api/docs
servers:
- url: https://tana.inc
description: Tana docs host (product defaults to tana)
- url: https://outliner.tana.inc
description: Tana Outliner docs host (product defaults to outliner)
tags:
- name: Docs
paths:
/api/docs/index:
get:
operationId: getDocsIndex
summary: Get the full documentation index
description: Returns the full documentation index with feature taxonomy, section outlines, and descriptions as markdown.
responses:
'200':
description: Documentation index.
content:
text/markdown:
schema:
type: string
tags:
- Docs
/api/docs/search:
get:
operationId: searchDocs
summary: Search documentation by text pattern
description: Search documentation by text pattern, optionally scoped to feature areas. Returns matching document paths, titles, descriptions, and summaries.
parameters:
- name: q
in: query
required: true
description: Search pattern. Minimum 2 characters.
schema:
type: string
minLength: 2
- name: features
in: query
required: false
description: Comma-separated feature keys to scope the search (e.g. ai-chat,types). Only docs tagged with these features are searched.
schema:
type: string
- name: product
in: query
required: false
description: 'Product to search: `tana` or `outliner`. Defaults to the product of the host you are querying.'
schema:
type: string
enum:
- tana
- outliner
- name: limit
in: query
required: false
description: Maximum number of results to return.
schema:
type: number
responses:
'200':
description: Search results.
content:
application/json:
schema:
type: object
properties:
query:
type: string
features:
type: string
nullable: true
product:
type: string
results:
type: array
items:
type: object
properties:
path:
type: string
title:
type: string
description:
type: string
tldr:
type: array
items:
type: string
tags:
- Docs
/api/docs/read:
get:
operationId: readDoc
summary: Read a full page or a specific section as clean markdown
description: Read a full documentation page or a specific section as clean markdown.
parameters:
- name: path
in: query
required: true
description: Document path in the format product/type/slug, using the singular docType key (e.g. tana/feature/ai-chat, outliner/help/getting-started). This is the path returned in search results.
schema:
type: string
- name: section
in: query
required: false
description: Heading id to extract a single section (e.g. model-selection). Use "intro" for content before the first heading.
schema:
type: string
- name: format
in: query
required: false
description: 'Output format: markdown (default, MDX stripped) or raw (original MDX source).'
schema:
type: string
enum:
- markdown
- raw
default: markdown
responses:
'200':
description: Document content as markdown.
content:
text/markdown:
schema:
type: string
tags:
- Docs
externalDocs:
description: Tana Documentation API (self-describing manifest)
url: https://tana.inc/api/docs