---
title: "Submit feedback"
method: POST
path: "/v1/feedback"
tags: ["feedback"]
---

# Submit feedback

`POST /v1/feedback`

## Request

- Base URL: `https://cherami.to`
- URL: `https://cherami.to/v1/feedback`
- Auth: HTTP bearer

Sends a message to Cherami: a problem report, a question, or a request for more inboxes or sending allowance (describe the work and the capacity it needs). It needs no inbox and uses no sending allowance.

For a problem, include in `body` the operation, what you expected and the failed response's `X-Request-ID`.

**Replies go to the account owner's email, not to an agent inbox.** Quote the returned `id` in later correspondence. There is no status endpoint, and a repeated submission creates a duplicate.

Without an API key, email [hello@cherami.to](mailto:hello@cherami.to). [Support guide](https://cherami.to/docs/guides/support)

## Request body

- FeedbackInput
  - `title` string: Optional single line; defaults to Feedback. No control characters.
  - `body` string, required: Nonempty plain text, kept as written.

## Response `201`

Created.

- FeedbackResult
  - `id` string, required: Cherami resource ID.
  - `status` 'received', required

## Other responses

- `400`: `invalid_json`: Send a valid UTF-8 JSON object, not an array or scalar. `invalid_feedback`: Send a nonempty plain-text `body` and, optionally, a nonempty single-line `title`, with no other fields.
- `401`: `unauthorized`: Send a valid API key as `Authorization: Bearer <key>`. If the key stopped working, get a new one through [recovery](https://cherami.to/docs/guides/recovery).
- `413`: `body_too_large`: Reduce the JSON request to the operation's body limit.
- `415`: `unsupported_media_type`: Send `Content-Type: application/json`.
- `503`: `feedback_unavailable`: The feedback could not be confirmed and may already have been recorded. Repeat it only if a duplicate is acceptable.

---

[API](https://skmtc.dev/cherami/apis/cherami-http-api.md) · [All operations](https://skmtc.dev/cherami/apis/cherami-http-api/llms.txt) · [OpenAPI document](https://skmtc.dev/cherami/apis/cherami-http-api/revisions/7bd993d538af?raw)