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.
File Conversion
Convert HTML and ZIP files to Markdown.
Rate Limits
Understand request quotas and throttling.
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_abc123def456Creating API tokens
- Sign in to your dashboard
- Navigate to API Tokens in the sidebar
- Click Create Token and give it a name
- 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:
| Plan | Max tokens |
|---|---|
| Free | 2 |
| Pro | 10 |
| Business | 50 |
| Enterprise | Unlimited |
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
| Method | Path | Description |
|---|---|---|
POST | /api/v1/convert | Convert a file to Markdown |
Next steps
- File Conversion — endpoint reference and examples
- Rate Limits — quotas and throttling details
- Plans & Limits — compare plan features