Endpoints

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 names one of its Computers in computer.

Feedback counts against the rate limit 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

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

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