# Feedback an bimetrics senden (https://developer.bimetrics.de/reference/feedback/send-feedback)

`POST https://app.bimetrics.de/api/feedback`

operationId: `sendFeedback` · Berechtigung (Scope): `read` · Bereich: Feedback

Sendet Feedback zu bimetrics an das bimetrics-Team, wie `send_feedback` per MCP: was du vorhattest, was geklappt hat, was nicht und was besser werden soll. In deiner Firma ändert sich nichts. Pflicht sind `outcome` und `intent` mit 3 bis 300 Zeichen, dazu mindestens eines von `wentWell`, `wentWrong` und `improve` mit je höchstens 2000 Zeichen. Fehlt ein Text oder steht nur ein Fülltext wie „test“ darin, antwortet die Route mit `400 FeedbackEmpty`. Ein ungültiges Feld ergibt `400 BadRequest`, `context.field` nennt es. `refs` nennt höchstens 10 betroffene Pfade oder Werkzeuge, etwa `/api/document/filter` oder `search_documents`. Texte mit E-Mail-Adressen, Links, IBANs oder unsichtbaren Steuerzeichen lehnt die Route mit `400 UnsafeMCPText` ab, `context.reason` nennt den Grund: `mail`, `link`, `iban` oder `control`. Bitte keine Namen von Kunden, Lieferanten oder Mitarbeitenden, keine Beträge und keine Beleginhalte. Je Firma gehen höchstens 10 Meldungen in 24 Stunden (API und MCP zusammen), je Schlüssel 3 in einer Stunde. Danach antwortet die Route mit `429 FeedbackLimit` und speichert nichts; der Header `Retry-After` nennt die Sekunden, bis wieder eine Meldung geht. Kommt dasselbe Feedback innerhalb von 10 Minuten noch einmal, speichert bimetrics es nicht doppelt und antwortet mit der gespeicherten `id` und `replayed: true`. Einen Idempotency-Key braucht die Route nicht. bimetrics löscht Feedback nach 180 Tagen, mit der Firma auch früher.

Benötigt einen Schlüssel mit der Berechtigung `read`.

### Authentifizierung

`Authorization: Bearer bm_…` (alternativ `X-API-KEY: bm_…`, nie beide zugleich).

### Request-Body (`application/json`)

feedback

Schema `FeedbackRequest`.

| Feld | Typ | Beschreibung |
| --- | --- | --- |
| `improve` | string | Was besser werden soll, höchstens 2000 Zeichen. |
| `intent` | string | Pflicht: was du mit bimetrics tun wolltest, in wenigen Worten, 3 bis 300 Zeichen. |
| `outcome` | string: `worked`, `improvable`, `failed`, `missing` | Pflicht: `worked` (hat zuverlässig geklappt), `improvable` (hat geklappt, sollte aber besser werden), `failed` (hat nicht geklappt) oder `missing` (bimetrics hat dafür keine Funktion). |
| `refs` | Array<string> | Betroffene Pfade oder Werkzeuge, höchstens 10 mit je höchstens 80 Zeichen aus Buchstaben, Ziffern und `_/:.{}-`. |
| `wentWell` | string | Was gut und zuverlässig geklappt hat, höchstens 2000 Zeichen. |
| `wentWrong` | string | Was nicht geklappt hat oder fehlt: die Route und der Fehlercode, ohne die Daten, um die es ging. Höchstens 2000 Zeichen. |

### Beispiel

```sh
curl --fail-with-body "https://app.bimetrics.de/api/feedback" \
  -H "Authorization: Bearer $BIMETRICS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"kind":"and","children":[],"limit":50,"offset":0}'
```

### Antworten

| Status | Beschreibung | Inhalt |
| --- | --- | --- |
| 200 | Erfolg. | `application/json`: FeedbackSaved |
| 400 | Ungültige Anfrage, z. B. ein Parameter mit ungültigem Wert wie eine ID, die keine UUID ist; korrigieren statt wiederholen. Mehr unter [Fehler](https://developer.bimetrics.de/errors). | `application/json`: Error |
| 401 | Kein gültiger Schlüssel: fehlt (`Unauthorized`), ist unbekannt, abgelaufen oder widerrufen oder wurde nicht in genau einem Header gesendet (`InvalidAPIKey`). Schlüssel prüfen, nicht wiederholen. Auch eine ID, die zu einer anderen Firma gehört, ergibt `401 Unauthorized`. | `application/json`: Error |
| 403 | Dem Schlüssel fehlt die Berechtigung für diesen Endpunkt (`APIKeyPermissionDenied`, `context.scope` nennt sie; Berechtigungen sind fest: neuen Schlüssel anlegen, austauschen, alten widerrufen), der Endpunkt ist für API-Schlüssel nicht freigegeben (`APIKeyPermissionDenied` ohne `context.scope`), oder die Firma hat keinen API-Zugang (mehr), etwa nach Ende der Testphase oder des Abos (`APIUnavailable`). | `application/json`: Error |
| 413 | Die Anfrage ist zu groß (`APIRequestTooLarge`), siehe `x-bimetrics-limits`. | `application/json`: Error |
| 429 | Zu viele Anfragen; nach `Retry-After` Sekunden erneut senden. Mehr unter [Fehler](https://developer.bimetrics.de/errors). (Header: Retry-After) | `application/json`: Error |
| 500 | Serverfehler; die Anfrage später wiederholen. Mehr unter [Fehler](https://developer.bimetrics.de/errors). | `application/json`: Error |

#### Felder der Antwort 200 (`FeedbackSaved`)

| Feld | Typ | Beschreibung |
| --- | --- | --- |
| `id` | string (uuid) | ID des Feedbacks. |
| `replayed` | boolean | `true`, wenn dasselbe Feedback innerhalb von 10 Minuten schon kam und nichts neu gespeichert wurde. |

Verschachtelte Schemas stehen vollständig in der OpenAPI-Beschreibung: https://app.bimetrics.de/api/openapi.json
