Automatisierung lesen
Benötigte Berechtigung:automations:read
Echte Wirkung
/api/agent-rule-group/{id}Kein Testversand aus der Dokumentation: Dieser Aufruf ist nicht als rein lesend gekennzeichnet. Nutze das Codebeispiel.
Liefert eine Automatisierung mit ihren Regeln. updatedAt schickst du beim Ändern als expectedUpdatedAt zurück.
Benötigt einen Schlüssel mit der Berechtigung automations:read.
AuthentifizierungBearer <bm_…>Empfohlen: Authorization: Bearer bm_…. Der Schlüssel wird nur einmal angezeigt; nie in URLs, Logs oder Frontend-Code ablegen.
id*stringID der Automatisierung in dieser Firma (UUID).
uuidErfolg.
application/json- response
Eine Automatisierung mit ihren Regeln.
active?booleantrue: Ihre Regeln wirken auf neue Uploads und Korrekturen.
companyId?stringID der Firma.
uuidcreatedAt?stringZeitpunkt des Anlegens.
date-timedisplayName?stringName der Automatisierung.
id?stringID der Automatisierung.
uuidrules?array<>|Die Regeln der Automatisierung.
updatedAt?stringZeitpunkt der letzten Änderung; beim Ändern als expectedUpdatedAt zurückschicken.
date-timecurl --fail-with-body "https://app.bimetrics.de/api/agent-rule-group/497f6eca-6276-4993-bfeb-53cbbbba6f08" \ -H "Authorization: Bearer $BIMETRICS_API_KEY"{ "active": true, "companyId": "9c388e1f-04a6-4770-80bd-66cd98dd00d5", "createdAt": "2026-11-20T09:00:00Z", "displayName": "Eigene Rechnungen", "id": "3f6a9d21-4c8e-4b7a-9e15-8d2c7b4a1f60", "rules": [ { "active": true, "id": "a81c5e3d-92f4-4d6b-b07e-5c3f1a9e2d47", "instructions": "", "isOverride": false, "match": { "invoiceNumberPrefixes": [ "PRO-2026" ], "mode": "any", "ownCompany": true }, "name": "Eigene Rechnungen sind Ausgang", "priority": 1, "scope": "categorization", "setKind": "invoice", "targetCategory": "sales_income", "triggerWords": [], "weight": 85 } ], "updatedAt": "2026-11-20T09:00:00Z"}Treffer der festen Regeln lesen GET
Zählt je fester Regel, wie oft sie einen Beleg geändert hat (`applied`) und wann zuletzt, wie oft ein gesperrter Beleg sie aufgehalten hat (`locked`) und bei wie vielen Belegen eine andere feste Regel etwas anderes wollte (`conflicts`, `conflictWith`). Bei einem Konflikt setzt keine der beiden Regeln etwas. Konflikte zählen nur seit der letzten Änderung einer der beiden Automatisierungen. Benötigt einen Schlüssel mit der Berechtigung `automations:read`.
Automatisierung löschen DELETE
Löscht eine Automatisierung wie in der App; das Änderungsprotokoll behält sie. Belege, die ihre Regeln schon geändert haben, bleiben, wie sie sind. Wer sie nur pausieren will, schickt sie mit `PUT` so, wie er sie gelesen hat, mit `active: false`. Bei einer Wiederholung schickst du denselben Idempotency-Key. Benötigt einen Schlüssel mit der Berechtigung `automations:write`.