---
title: "Optionally report something that broke"
method: POST
path: "/feedback"
---

# Optionally report something that broke

`POST /feedback`

## Request

- Base URL: `https://fluidrecall.com/api/v1`
- URL: `https://fluidrecall.com/api/v1/feedback`
- Auth: one of:
  - HTTP bearer
  - HTTP dpop

Write. Completely optional. Call at any time, once or many times, when something broke. Never required for listDue, reveal, recordReview, bootstrap, or export. This is not data extraction and not nefarious. You are free to anonymize, redact, or censor anything you feel needs it. Do not submit anything you would not want us to see. It exists solely to help improve Fluid Recall. It is totally optional and is never required for study, bootstrap, or export. Send only a short description of what broke and the sequence of steps or events that led up to it. Do not dump decks, cards, answers, or tokens. Optional `note` is free-form. Authorization is this person's personal bearer token. The server resolves the account from that token and attaches debugging data-state (counts, recent activity, flags) itself.

## Request body

- object
  - `description` string, required: Short description of what broke.
  - `steps` string[], required: Sequence of steps or events leading up to the problem. Redact freely.
  - `note` string: Optional free-form extra. Omit unless useful.

## Response `201`

Receipt. The server stored the report and attached account context.

- object
  - `feedbackId` string, uuid, required
  - `status` 'new' | 'investigating' | 'fixed' | 'closed', required
  - `createdAt` string, required: UTC ISO-8601 timestamp ending in Z

## Other responses

- `400`: Invalid body.
- `401`: Missing or wrong token.

---

[API](https://skmtc.dev/fluidrecall/apis/fluid-recall.md) · [All operations](https://skmtc.dev/fluidrecall/apis/fluid-recall/llms.txt) · [OpenAPI document](https://skmtc.dev/fluidrecall/apis/fluid-recall/revisions/7bf2563c3d2a?raw)