Back to Etu

API Documentation

Etu exposes a Connect RPC API. Use the packages below or call the proto services directly.

Client packages

  • TypeScript / JavaScript
    @icco/etu-proto

    Generated Connect RPC client and types. Published to GitHub Packages.

    Source (etu-backend)
  • Go
    github.com/icco/etu-backend/proto

    Go client and generated code from the same proto definitions.

    etu-backend repository

Authentication

API requests use an API key in the Authorization header. The backend expects the raw key (not Bearer <key>).

  1. Log in at etu.app (or your instance).
  2. Go to Settings → API Keys and create a key. Copy it once—it won’t be shown again.
  3. Send it on every request: Authorization: <your-api-key>

For user-scoped calls (notes, tags, etc.) the backend derives your user from the API key. The web app uses session cookies; the API uses the key only.

Proto reference

Full protocol buffer and service definitions.

Open Proto Documentation