E-Mail Outbound

Die Email Outbound API ermöglicht das Senden von E-Mails aus Optimaite, die Verwaltung von Entwürfen und das Erzeugen vorausgefüllter Antwort-/Weiterleitungs-Umschläge.

Endpunkte

Method	Path	Beschreibung
POST	/api/v1/email/outbound/drafts	E-Mail-Entwurf erstellen
GET	/api/v1/email/outbound/drafts	Entwürfe des aktuellen Nutzers auflisten
GET	/api/v1/email/outbound/drafts/{id}	Entwurf per ID abrufen
PUT	/api/v1/email/outbound/drafts/{id}	Entwurf aktualisieren (Autosave)
DELETE	/api/v1/email/outbound/drafts/{id}	Entwurf löschen
POST	/api/v1/email/outbound/drafts/{id}/send	Bestehenden Entwurf senden
POST	/api/v1/email/outbound/send	E-Mail direkt senden (ohne Entwurf)
POST	/api/v1/email/outbound/reply-envelope	Vorausgefüllten Antwort-Umschlag abrufen
POST	/api/v1/email/outbound/forward-envelope	Vorausgefüllten Weiterleitungs-Umschlag abrufen
GET	/api/v1/email/outbound/signature	Standard-E-Mail-Signatur abrufen

Das Entwurfs-Objekt

{
  "id": "draft_01ABCDEFG",
  "to": ["client@example.com"],
  "cc": [],
  "bcc": [],
  "subject": "Re: Contract Review",
  "body_html": "<p>Dear Mr. Smith,</p><p>...</p>",
  "attachments": [
    {
      "document_id": "doc_01ABCDEF",
      "filename": "contract_v2.pdf"
    }
  ],
  "case_id": "550e8400-e29b-41d4-a716-446655440000",
  "status": "draft",
  "created_at": "2026-05-20T14:00:00Z",
  "updated_at": "2026-05-20T14:05:00Z"
}

Entwurf erstellen

POST /api/v1/email/outbound/drafts

{
  "to": ["client@example.com"],
  "subject": "Re: Contract Review",
  "body_html": "<p>Dear Mr. Smith,</p><p>Please find the updated contract attached.</p>",
  "case_id": "550e8400-e29b-41d4-a716-446655440000",
  "attachments": ["doc_01ABCDEF"]
}

Direkt senden

POST /api/v1/email/outbound/send

E-Mail senden, ohne einen Entwurf ausdrücklich zu verwalten. Erzeugen Sie für die Sendeaktion eine UUID und verwenden Sie bei jedem Wiederholungsversuch denselben idempotency_key. Eine Wiederverwendung mit anderem Inhalt wird abgelehnt.

{
  "idempotency_key": "5de89f5e-c224-4f6d-a9a0-cb976cd30e82",
  "to_recipients": ["opposing.counsel@lawfirm.de"],
  "cc_recipients": ["partner@optimaite.eu"],
  "subject": "Response to Your Letter dated May 15",
  "body_html": "<p>Dear Colleague,</p><p>...</p>"
}

Antwort

Liefert 200 OK mit der providerneutralen Identität der gesendeten E-Mail:

{
  "success": true,
  "email_id": "0198ef9a-03c7-74cb-a29b-4ad9e6bf33ac",
  "message_id": "provider-message-id",
  "sent_at": "2026-05-20T14:10:00Z"
}

Antwort- / Weiterleitungs-Umschläge

Vorausgefüllten Entwurfs-Umschlag auf Basis eines bestehenden Korrespondenz-Eintrags abrufen:

POST /api/v1/email/outbound/reply-envelope

{
  "correspondence_id": "corr_01INBOUND",
  "reply_all": false
}

Liefert ein Entwurfs-Objekt mit vorausgefüllten to, subject (mit „Re:“), body_html (zitiertes Original) und Aktenkontext.

Signatur

GET /api/v1/email/outbound/signature

Liefert die konfigurierte E-Mail-Signatur des aktuellen Nutzers für Entwürfe.

Fehlerantworten

Status	Code	Bedeutung
400	VALIDATION_ERROR	Pflichtfelder fehlen (to, subject)
403	AUTH_INSUFFICIENT_SCOPE	Fehlender Scope inbox:write
404	DRAFT_NOT_FOUND	Entwurfs-ID existiert nicht
413	ATTACHMENT_TOO_LARGE	Gesamtgröße der Anhänge überschritten

Nächste Schritte

• E-Mail Inbound -- E-Mails empfangen und verarbeiten
• beA-Postfach -- Deutsches elektronisches Anwaltspostfach
• Dokumente -- Dokumente an E-Mails anhängen