Thogits API Documentation

Schema-aware knowledge management. Organize anything with typed tags, powerful filtering, and a fully programmable API.

API-First

Every feature in Thogits is available through the REST API and MCP tools. The base URL for all API requests is:

https://app.thogits.com/api/

Schema-Aware Tags

Tags aren’t labels. Each tag defines a typed schema with fields like String, Number, Date, Select, and Reference. Tagging an entry gives it structured data.

Powerful Filtering

Query with a composable filter DSL. Filter by tag presence, field values, date ranges, and traverse references across entries.

Composable Structure

Any thogit can have any combination of tags. Tags define typed fields. No fixed schemas — compose structure as you go.

MCP Integration

Connect Claude or any MCP-compatible client to manage your knowledge through 29+ tools.

Core Model

Thogit (Entity)
├── name, description
└── tags applied:
    ├── Task
    │   ├── status: Select [Todo, In Progress, Done]
    │   ├── priority: Number
    │   └── due_date: Date
    └── Project
        ├── owner: Reference → another Thogit
        └── budget: Number

A Thogit is an entry — a note, task, person, anything. Tags give it structure. Each tag defines fields and their types. Any combination of tags on any thogit.

Quick Example

# Create a tag with a typed schema
curl -X POST https://app.thogits.com/api/tags \
  -b cookies.txt -c cookies.txt \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Task",
    "fields": {
      "status": {
        "type": "Select",
        "variants": [{"name": "Todo"}, {"name": "In Progress"}, {"name": "Done"}]
      },
      "priority": "Number"
    }
  }'

# Create a thogit with that tag
curl -X POST https://app.thogits.com/api/thogits \
  -b cookies.txt -c cookies.txt \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Ship v2 API docs",
    "description": "Write comprehensive API documentation",
    "tags": [{
      "tag_ref": {"Existing": "TAG_ID_HERE"},
      "field_values": {
        "status": {"variant": "In Progress"},
        "priority": 1
      }
    }]
  }'

# Search for high-priority open tasks
curl -X POST https://app.thogits.com/api/thogits/search \
  -b cookies.txt -c cookies.txt \
  -H "Content-Type: application/json" \
  -d '{
    "filter": {
      "and": [
        {"has_tag": "Task"},
        {"Task.priority": {"lte": 2}},
        {"not": {"Task.status": {"match": "Done"}}}
      ]
    }
  }'