bimetricsEntwickler
Automatisierungen

Automatisierung lesen

Als Markdown ansehen

Benötigte Berechtigung:automations:read

Echte Wirkung

Dieser Aufruf ist nicht als rein lesend gekennzeichnet und kann echte Daten in der Firma anlegen oder ändern. Es gibt keine Testumgebung.
get/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.

Authentifizierung

headerAuthentifizierungBearer <bm_…>

Empfohlen: Authorization: Bearer bm_…. Der Schlüssel wird nur einmal angezeigt; nie in URLs, Logs oder Frontend-Code ablegen.

Pfadparameter

id*string

ID der Automatisierung in dieser Firma (UUID).

Formatuuid

Antworten

Erfolg.

application/json
  1. response

Eine Automatisierung mit ihren Regeln.

active?boolean

true: Ihre Regeln wirken auf neue Uploads und Korrekturen.

companyId?string

ID der Firma.

Formatuuid
createdAt?string

Zeitpunkt des Anlegens.

Formatdate-time
displayName?string

Name der Automatisierung.

id?string

ID der Automatisierung.

Formatuuid
rules?array<>|

Die Regeln der Automatisierung.

updatedAt?string

Zeitpunkt der letzten Änderung; beim Ändern als expectedUpdatedAt zurückschicken.

Formatdate-time
Beispielanfrage
curl --fail-with-body "https://app.bimetrics.de/api/agent-rule-group/497f6eca-6276-4993-bfeb-53cbbbba6f08" \  -H "Authorization: Bearer $BIMETRICS_API_KEY"
Beispielantwort
{  "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"}