YaTTI

Home › Developers

YaTTI Knowledgebase API

A RESTful API for querying specialized knowledgebases using AI-powered retrieval-augmented generation (RAG). Ask natural-language questions across domains including Indonesian law, anthropology, Buddhist philosophy, puppet theater, AI documentation, and more.

Get Started in 30 Seconds

Install the CLI client

curl -fsSL https://yatti.id/v1/install | bash

Auto-detects your system, installs to ~/.local/bin, and verifies GPG signature.

Configure your API key

yatti-api configure

The demo query on the homepage works without an API key. For full API access, request a key.

Query a knowledgebase

yatti-api query appliedanthropology "What is participatory action research?"

Or use curl directly:

curl -s -X POST https://yatti.id/v1/query \
  -H "Content-Type: application/json" \
  -H "X-API-Key: your-key" \
  -d '{"knowledgebase": "appliedanthropology", "query": "What is participatory action research?"}' | jq

API Reference

Public Endpoints

GET /v1/API information and endpoint listing
GET /v1/statusService status
GET /v1/docsUser documentation
GET /v1/docs/apiTechnical API documentation

Authenticated Endpoints (requires X-API-Key header)

GET /v1/knowledgebasesList available knowledgebases
GET /v1/knowledgebases/{name}Get knowledgebase details
POST /v1/querySubmit a query
GET /v1/queryQuery history
GET /v1/query/{uuid}Get specific query result

Full API documentation →

CLI Client

The yatti-api CLI client supports all API endpoints with self-updating, GPG signature verification, and local configuration.

yatti-api statusCheck API status and connectivity
yatti-api kbList available knowledgebases
yatti-api kb {name}Get knowledgebase details
yatti-api query {kb} "question"Query a knowledgebase
yatti-api historyView query history
yatti-api updateSelf-update to latest version

View changelog →

Response Format

{
  "success": true,
  "data": {
    "query_id": "uuid",
    "knowledgebase": "appliedanthropology",
    "query": "What is participatory action research?",
    "response": "Participatory action research (PAR) is...",
    "contexts": [...],
    "metadata": {"model": "...", "processing_time": 2.1}
  },
  "timestamp": "2026-03-22T12:00:00+07:00"
}