REST API

API keys

In the app, open Settings, turn on Show advanced tools, and create a key under API keys. It is shown once and starts with crt_. Send it as Authorization: Bearer crt_…. A key can read and write everything you study but cannot manage your account or its keys. Revoking a key stops whatever uses it at once.

A first request

All routes live under https://app.lectro.ai/api/v1. This one creates a note and files it in a node:

curl https://app.lectro.ai/api/v1/notes \
  -H "Authorization: Bearer crt_…" \
  -H "Content-Type: application/json" \
  -d '{
    "notetype_id": "…",
    "fields": { "Front": "Why does SN2 invert?", "Back": "Back-side attack." },
    "node_ids": ["…"]
  }'

Conventions

• Bodies are JSON with snake_case fields. IDs are UUIDv7 strings.
• Times are ISO-8601 in UTC.
• Reviews take a client_request_id, so a retried request is recorded once.
• Requests are rate limited per client; past the limit you get a 429 with code rate_limited.

Errors

Every error has the same shape, with a stable code beside the HTTP status:

{
  "error": {
    "code": "validation_failed",
    "message": "Invalid request",
    "details": [
      { "keyword": "invalid_type", "instancePath": "/notetype_id", "message": "…" }
    ]
  }
}

Routes