Distill bietet eine lokale REST-API auf Port 43821 (konfigurierbar). Im DMG-Build ist sie standardmäßig aktiv, in der App-Store-Version ist sie aus Apple-Richtliniengründen opt-in unter Einstellungen → API. Optionale Token-Authentifizierung. Eine interaktive Swagger-UI ist unter /v1/docs verfügbar, die OpenAPI-Spec unter /v1/openapi.json.
System
Methode
Endpunkt
Beschreibung
GET
/v1/health
Server-Status
GET
/v1/version
App-Version
GET
/v1/docs
Swagger-UI
GET
/v1/openapi.json
OpenAPI-Spec
Umbenennung
Methode
Endpunkt
Beschreibung
POST
/v1/suggest
Vorschläge generieren (legt Jobs an)
POST
/v1/rename
Suggest + Apply in einem Schritt
POST
/v1/revert
Umbenennung rückgängig machen
POST
/v1/analyze
Metadaten extrahieren ohne Rename
Jobs (interaktiver Workflow)
Workflow: POST /v1/suggest erzeugt Jobs → Jobs einzeln editieren oder genehmigen → POST /v1/jobs/apply.
Methode
Endpunkt
Beschreibung
GET
/v1/jobs
Aktuelle Vorschläge abrufen
PUT
/v1/jobs/{id}
Job editieren/genehmigen
POST
/v1/jobs/apply
Genehmigte Jobs anwenden
DELETE
/v1/jobs
Alle Jobs verwerfen
Verlauf
Methode
Endpunkt
Beschreibung
GET
/v1/history
Verlauf (Filter: search, provider, from, to, limit)
GET
/v1/history/{id}
Einzelner Eintrag
DELETE
/v1/history/{id}
Eintrag löschen
DELETE
/v1/history
Gesamten Verlauf löschen
Warteschlange (Batch)
Methode
Endpunkt
Beschreibung
GET
/v1/queue
Status + wartende Dateien
POST
/v1/queue
Dateien einreihen
POST
/v1/queue/pause
Queue pausieren
POST
/v1/queue/resume
Queue fortsetzen
DELETE
/v1/queue
Queue leeren
Konfiguration
Methode
Endpunkt
Beschreibung
GET / POST
/v1/providers
Provider lesen / wechseln
GET / POST
/v1/settings
Einstellungen lesen / setzen
GET / POST
/v1/rules
Regeln lesen / setzen
GET / POST
/v1/templates
Templates auflisten / anlegen
PUT / DELETE
/v1/templates/{name}
Template aktualisieren / löschen
GET / POST
/v1/watch
Ordnerüberwachung verwalten
PUT / DELETE
/v1/watch/{id}
Ordnerüberwachung aktualisieren / entfernen
GET / POST
/v1/pcs
PCS-Integration konfigurieren
POST
/v1/pcs/check
PCS-Verbindung prüfen
UI-Steuerung
Methode
Endpunkt
Beschreibung
GET
/v1/ui/state
Aktuelle UI-Ansicht
POST
/v1/ui/navigate
Tab wechseln
GET
/v1/ui/screenshot
Screenshot als PNG
MCP-Server
Der MCP-Server (distill-mcp-server) ermöglicht KI-Assistenten wie Claude die Steuerung von Distill. Er wird im DMG-Build automatisch im App-Bundle mitgeliefert und kommuniziert via REST mit der App. Konfiguration via Env-Vars DISTILL_API_PORT und DISTILL_API_TOKEN.
Die FinderSync-Extension fügt einen Eintrag „Mit Distill umbenennen“ ins Kontextmenü des Finders ein. Ausgewählte Dateien werden direkt an Distill übergeben. Die Extension muss in den Systemeinstellungen unter Erweiterungen aktiviert sein.