Skip to content

Marvin API

TODO: this page will document the local HTTP API the Hub exposes on localhost:8089 for the Companion and other local clients.

Endpoints to cover (current count: 14):

  • /health (with ?detailed=1)
  • /api/v1/calendar/*
  • /api/v1/people/{search, context, stale, recent, birthdays}
  • /api/v1/email/recent
  • /api/v1/suggestions
  • /api/v1/timeline
  • /api/v1/ingest/ios
  • /api/safari/ingest (gateway)

For each: method, path, request schema, response schema, auth model, rate limits, and example curl.

Owner: @andy. Cross-reference: the ical-server.py source on the Mac Mini, the gateway routes for the Safari ingest endpoint, and the security hardening rules (1 MB POST limit, content-type validation, _safe_int on query params).