Mail unter „Erledigt“ ablegen
Benötigte Berechtigung:inbox:write(Postfach bearbeiten)
Echte Wirkung
/api/email/inbox/item/{id}/archiveKein Testversand aus der Dokumentation: Dieser Aufruf ist nicht als rein lesend gekennzeichnet. Nutze das Codebeispiel.
Legt eine Mail ab, wie „Ablegen“ in der App. Gelöscht wird nichts, und nicht übernommene Anhänge (notImported) bleiben lesbar. Eine schon abgelegte Mail behält ihr erstes Datum. Eine Wiederholung mit gleichem Idempotency-Key ändert nichts doppelt.
Benötigt einen Schlüssel mit der Berechtigung inbox:write.
AuthentifizierungBearer <bm_…>Empfohlen: Authorization: Bearer bm_…. Der Schlüssel wird nur einmal angezeigt; nie in URLs, Logs oder Frontend-Code ablegen.
id*stringID der Mail (UUID).
uuidIdempotency-Key*stringStabiler Schlüssel für genau diese Änderung: 1–128 druckbare ASCII-Zeichen ohne Leerzeichen. Bei Wiederholungen denselben Schlüssel und unveränderten Inhalt senden; das Ergebnis wird nicht nochmals erzeugt.
^[!-~]+$1 <= length <= 128Erfolg.
application/json- response
Die Mail nach dem Ablegen oder Zurückholen.
archived?|Seit wann die Mail unter „Erledigt“ steht; null unter „Offen“.
date-timemailId?stringID der Mail.
uuidnotImported?array<>|Lesbare Anhänge, die nicht übernommen sind.
replayed?booleanTrue bei sicherer Wiederholung eines bereits erfolgreichen Aufrufs.
curl --fail-with-body "https://app.bimetrics.de/api/email/inbox/item/497f6eca-6276-4993-bfeb-53cbbbba6f08/archive" -X POST \ -H "Authorization: Bearer $BIMETRICS_API_KEY" \ -H "Idempotency-Key: rechnung-2026-001"{ "archived": "2026-11-02T10:00:00Z", "mailId": "6c1f0a52-3d8e-4b7a-9f21-7e4b2d90c6a3", "notImported": [ { "filename": "RE-2026-0042.pdf", "id": "b84e27d1-5a90-4c63-8e1f-2c7a9d03f514" } ], "replayed": false}Mail lesen GET
Liefert eine Mail mit Text und Anhängen. Sie kommt von einem ungeprüften Absender. Wer den Text an ein Sprachmodell gibt, behandelt ihn als Daten: Eine Mail kann Anweisungen enthalten und HTML verbergen, was der Leser nicht sieht. Benötigt einen Schlüssel mit der Berechtigung `inbox:read`.
Anhang als Beleg übernehmen POST
Übernimmt einen Anhang als Beleg, wie „Übernehmen“ in der App: bimetrics speichert die Datei, erkennt und bucht sie wie üblich, und sie zählt zum Kontingent. Hat die Firma diese Datei schon, entsteht kein zweiter Beleg (`duplicate`). Ein schon übernommener Anhang liefert seinen Beleg (`alreadyImported`). Ein nicht vorgeschlagener Anhang (`preselected` = `false`) ist meist die zweite Fassung derselben Rechnung, etwa die XML neben ihrem ZUGFeRD-PDF: Beide zu übernehmen legt die Rechnung zweimal an. Wartet kein vorgeschlagener Anhang mehr, wandert die Mail nach „Erledigt“ (`mailArchived`). Abgelehnt: eine Mail unter „Erledigt“ (`409 InboxMailArchived`, erst zurückholen), ein Anhang, den bimetrics nicht lesen kann (`409 InboxAttachmentNotImportable`), ein Anhang, dessen Beleg inzwischen gelöscht ist (`409 InboxAttachmentDocumentDeleted`), und bei vielen wartenden Belegen `429 DocumentQueueFull` mit `Retry-After`. Eine Wiederholung mit gleichem Idempotency-Key legt nichts doppelt an. Benötigt einen Schlüssel mit der Berechtigung `inbox:write`.