# Feedback

Source: https://heaven.dev/docs/feedback

Tell the Heaven team what worked and what got in your way.

## Send feedback

`POST /v1/feedback/create`

Tells the Heaven team what worked, what got in your way or what you expected.

Only the team reads feedback, so there's no `GET`. Every credential can send it, even a key whose commands don't name `feedback`, so an agent can always say what got in its way. A key with a [scope](https://heaven.dev/docs/authentication#scope) names one of its Computers in `computer`.

Feedback counts against the [rate limit](https://heaven.dev/docs/errors#rate-limits) as a command, not a change. Over SSH, it's `ssh heaven.dev feedback "TEXT"`. Through MCP, it's the `feedback` tool.

#### Body

- `text` string *required*: What worked, what got in the way, or what you expected, up to 16 KiB.
- `computer` string: The Computer it is about.

#### Response

- `id` string: The note's ID.
- `computer_id` string: The Computer's ID, when you named one.

- Any API key can run it.

Request:

```sh
curl https://heaven.dev/v1/feedback/create \
  -H "Authorization: Bearer $HEAVEN_API_KEY" \
  --json '{"text": "Creating a Computer from the API was easy. I expected exec to keep the working directory between calls."}'
```

200:

```json
{
  "version": 1,
  "data": {
    "id": "65085b2f-40df-4d59-955a-7c6c43a449d4",
    "request_id": "c544228e-7fb7-4a46-b9c7-88559c590b82",
    "created_at": "2026-11-01T23:18:35Z"
  }
}
```