Skip to content

API Reference Overview

This page provides a quick reference of all available API endpoints. Click on any domain name to see its full documentation.

Before using any endpoint, read the Concepts section to understand authentication, envelope format, and pagination.

DomainBase pathOperations
Notes/notesCRUD, archive, custom fields
Events/eventsCRUD, recurrence, custom fields
Contacts/contactsCRUD, custom fields
Emails/emailsCRUD, send, snooze, batch, read/star
Email Accounts/email-accountsCRUD, test connection, IMAP folders
Files & Drive/filesUpload, mkdir, CRUD, preview, download
Photos/photos, /albumsTimeline, search, albums, AI pipeline
Diary/diaryCRUD, append, stats
Bookmarks/bookmarksCRUD, tags, domains, check-alive
Feeds (RSS)/feedsSubscribe, discover, articles, OPML
Search/searchCross-domain full-text and semantic search
Entity Links & Graph/links, /graphCross-domain entity relationships
Kanban (Projects)/kanbanBoards, columns, cards, labels, checklists
Diagrams/diagramsCRUD for diagram documents
DomainBase pathOperations
Storage (HAL)/storageVolumes, SMART data, mount points
Network & Proxy/network, /hal/network/proxyInterfaces, reverse proxy, SSL
DNS/dnsZones, records, DDNS, providers
VPN/wg-easy, /hal/network/tailscaleWireGuard, Tailscale
Processes/hal/processesProcess manager
Managed Services/portainer, /termixDocker containers lifecycle
DomainBase pathOperations
Digest Engine/digestPending changes, config, smart digest
Knowledge Graph/graphEntity relationships, visualization
Entity Extraction/graph/re-extractBatch entity extraction pipeline
Voice (STT/TTS)/voiceSpeech-to-text, text-to-speech
DomainBase pathOperations
Finance Suite/financeFirefly III + SolidInvoice lifecycle
Crypto Stack/cryptoBTC, Lightning, Monero, Electrs
Mail Server/mail/serverDNS checks, relay, provisioning
Multimedia Suite/multimediaServarr stack setup and management

All endpoints share these conventions:

  • Authentication: Bearer token in Authorization header (details)
  • Envelope: Responses wrapped in { data } or { data, meta } (details)
  • Pagination: ?limit= and ?offset= on all list endpoints (details)
  • Compact format: ?format=compact for token-optimized responses (details)
  • Soft deletes: DELETE sets deleted_at, ?permanent=true for hard delete (details)