Feedback

Eine Fehlermeldung oder eine Idee aus der laufenden Anwendung heraus einsenden. Mit Sitzung und bewusst außerhalb von /workspaces/{workspaceId}: Die Meldung ist an die Betreiber der Instanz gerichtet und nicht an einen Workspace — deshalb ist sie nur mit Sitzung erreichbar, und deshalb begründet der genannte Workspace keine Berechtigung. Mit unterwegs sind der Bildschirm, auf dem sie geschrieben wurde, die Version, das Fenster, die Eingabeart und eine strukturelle Aufzeichnung dessen, was die Anwendung getan hat — nie etwas, das jemand geschrieben hat. Betreiber lesen sie im Backoffice.

1 Operation. Jeder Pfad ist relativ zum Ursprung der Instanz; jeder Antwortkörper ist JSON, sofern nicht anders vermerkt. Die Endpunktbeschreibungen unten stammen unverändert aus der Routentabelle des Servers und bleiben englisch. Authentifizierung, Fehler und seitenweise Abfrage stehen unter API.

POST /api/v1/feedback

File a bug report or an idea from inside the product (ADR-0039). Authenticated — the session hook covers it — but outside /workspaces/{workspaceId}, because the report is addressed to the instance OPERATOR rather than to a workspace, which also makes it session-only for tokens. Carries the machine's half of the report: the route pattern, the build, the viewport, the pointer and the flight recorder's markdown, which is structure-only by construction and holds no row text, title or meeting summary. workspaceId is where the sender was standing and is never used as an authorisation. Rate-limited per account. Answers an id and a receipt time, and promises no reply.

createFeedbackReport · token scope: session only

Request body — application/json, required

• kind · "bug" | "idea" — required
• message · string — required, length 1–4000
• workspaceId · string (uuid) | null — required
• context · object — required
  • route · string | null — required
  • appVersion · string | null — required
  • viewport · object | null — required
    • width · integer — required, 0–100000
    • height · integer — required, 0–100000
  • pointer · "coarse" | "fine" | null — required
  • trace · string | null — required

Response 200 — application/json

• id · string (uuid) — required
• receivedAt · string (date-time) — required

Response default — application/json

• error · object — required
  • code · "bad_request" | "validation_failed" | "unauthorized" | "forbidden" | "not_found" | "conflict" | "rate_limited" | "internal" — required
  • message · string — required
  • reason · string — length 1–64