← Doku

REST-API v1

Programmgesteuerter Zugriff auf Threads, Nachrichten und Versand.

Die REST-API v1 gibt programmatischen Zugriff auf Threads und ihre Nachrichten. Basis-URL: https://app.astreo.de/api/v1.

Authentifizierung

Jede Anfrage trägt ein Personal Access Token im Header:

curl https://app.astreo.de/api/v1/threads \
  -H "Authorization: Bearer astreo_pat_xxxxxxxx"

Threads

Threads auflisten (mit Filtern wie unread) und einzeln abrufen:

GET /api/v1/threads
GET /api/v1/threads?unread=1
GET /api/v1/threads/{id}

Die Antwort enthält u. a. Betreff, Absender, Zeitpunkt, Status und Zuweisung; der Einzelabruf liefert den Verlauf.

Nachrichten

Die Nachrichten einer Konversation sind Teil des Thread-Details (GET /api/v1/threads/{id}). Interne Notizen eines Threads sind separat abrufbar: 

GET /api/v1/threads/{id}/notes

Senden

KI-/Agenten-Workflows folgen bei Astreo dem Entwurfsprinzip: Vorschläge entstehen als editierbarer Entwurf, der finale Versand bleibt eine bewusste Handlung. Für agentische Abläufe (Entwurf vorschlagen) ist der MCP-Server der vorgesehene Weg; Automatisierung auf Ereignisbasis läuft über Webhooks.

Fehler & Rate-Limits