REST API

The Aigon REST API gives you programmatic access to your notes, files, and search — the same endpoints that power the CLI and MCP server.

Base URL: https://api.aigon.ai

Documentation

The API is auto-documented via OpenAPI 3.1:

Swagger UI — interactive explorer, try endpoints directly
ReDoc — clean reference documentation
OpenAPI spec — raw JSON schema for code generation

Authentication

All endpoints require a Bearer token. API tokens that were issued earlier keep working; new API tokens are not currently issued, and the short-lived token from admin.mint_curl_token is refused here. See Authentication.

Authorization: Bearer YOUR_API_TOKEN

Endpoint Groups

Group	What it covers
notetaker	Read, search, update, and generate reports from your notes
filedb	Versioned text files, scoped by agent: create, read, write, roll back, rename, archive, delete
download	Download a note, attachment or file by its id
transcribe	Audio-to-text transcription
tokens	API token management
users	User provisioning
oauth	OAuth 2.0 client registration and token exchange

See the Swagger UI for the full endpoint list with request/response schemas.

Quick Example

# Read up to 5 of your notes
curl -X POST -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" -d '{"limit": 5}' \
  https://api.aigon.ai/notetaker/notes

# Search notes and attachments
curl -H "Authorization: Bearer YOUR_TOKEN" \
  "https://api.aigon.ai/notetaker/search?query=meeting"