Kamiby Typo Monster
Docs

API Reference

Programmatic access to Kami's conversion engine via REST API.

The Kami API lets you convert Notion HTML exports to Markdown programmatically. All API endpoints require authentication via bearer tokens.

Base URL

https://kami.typo.monster/api/v1

Authentication

All API requests require a bearer token in the Authorization header:

bash
Authorization: Bearer em_live_abc123def456

Creating API tokens

  1. Sign in to your dashboard
  2. Navigate to API Tokens in the sidebar
  3. Click Create Token and give it a name
  4. Copy the token immediately — it is only shown once

Token security

API tokens grant full access to your account's conversion quota. Treat them like passwords. Never commit tokens to version control or share them publicly.

Token limits

The number of active API tokens depends on your plan:

PlanMax tokens
Free2
Pro10
Business50
EnterpriseUnlimited

Revoking a token frees up a slot for a new one.

Response format

Successful responses return 200 with text/markdown content type (or application/json when format=json is specified).

Error responses return a JSON body:

json
{
  "error": {
    "code": "RATE_LIMIT_EXCEEDED",
    "message": "Daily conversion limit reached (5 for Free plan)"
  }
}

Available endpoints

MethodPathDescription
POST/api/v1/convertConvert a file to Markdown

Next steps