> For the complete documentation index, see [llms.txt](https://docs.khotan.com/llms.txt). A markdown version of any page is available at its `index.md` URL. # Feedback `/api/v1` operations for feedback. See [HTTP API](/api/) for authentication, the error envelope, and rate limits. ## Operations ### POST /api/v1/feedback Send feedback to the Khotan team Stores a feature request, product direction, docs gap, or bug from an agent. The agent states its proposal, the situation it was in, its reason, and whether a person asked it to send it. The server attributes the submission from the API key; for the Slack agent it also records the conversation and the member who asked. Every authenticated caller can send feedback, including the code sandbox's read-only key. Nothing reads submissions back over the API. Auth: API key required. Operation ID: `submitAgentFeedback` Request body (`application/json`, required): - `kind` ("feature_request" | "direction" | "docs_gap" | "bug" | …, required) — What kind of feedback this is. - `title` (string, required) — One line. - `proposal` (string, required) — What should be added or changed. - `situation` (string, required) — What the agent was doing: the task, its goal, and what it tried. - `reason` (string, required) — Why the agent sent it: what it had to do instead, and what the change would let it or its user do. - `origin` ("agent" | "user", required) — user when a person asked the agent to send it; agent when the agent decided to. - `workaround` (string, optional) - `impact` ("blocked" | "workaround" | "nice_to_have", optional) - `area` ("api" | "cli" | "mcp" | "slack_agent" | …, optional) - `capabilityIds` (string[], optional) — Khotan action ids this is about. A requested action may not exist yet. - `threadId` (string, optional) — The caller's own conversation or session id. - `model` (string, optional) - `client` (string, optional) — The agent product, such as cursor or claude-code. Responses: - `201` — The stored submission's id and time, and a note to carry on. - `400` — The request was malformed or failed validation. - `401` — Authentication is missing or invalid. - `429` — Too many requests; retry after the indicated delay. CLI: `khotan feedback submit`