API Documentation

Full REST API for programmatic access to all features

Base URL

your-app.vercel.app

Free Tier

20 req/hour · No key needed

API Tier

1,000 req/hour · X-API-Key header

Authentication

All endpoints work without authentication (free tier). Add your API key for higher rate limits:

curl https://your-app.vercel.app/api/notes \
  -H "X-API-Key: epic_your_key_here"

Rate Limit Headers: Every response includes X-RateLimit-Limit, X-RateLimit-Remaining, and X-Tier headers.

System

Chat / AI

Notes

Tasks

Flashcards

Error Codes

200Success
400Bad Request — missing or invalid parameters
429Rate Limit Exceeded — slow down or add API key
500Internal Server Error