---
title: "Send feedback"
description: "Sends feedback about Cool Computers to the team: a bug, a missing feature, or what worked."
canonical: "https://www.cool.computer/docs/api-reference/feedback/send-feedback"
---
# Send feedback

> Sends feedback about Cool Computers to the team: a bug, a missing feature, or what worked.

```http
POST https://api.cool.computer/api/feedback
```

Sends feedback about Cool Computers to the team: a bug, a missing feature, or what worked. The message holds 1-4000 characters, and the body is at most 64 KiB. No credential is needed. Without one the feedback is sent without an account: each client IP (an IPv6 address by its /64) sends at most 10 an hour, with at most 20 an hour from one IPv6 /48 and at most 300 an hour from all addresses together, and the server takes at most 4 at once, answering 429 feedback_busy with Retry-After otherwise. With an account bearer credential or a browser session it names that account and its email, and the account sends at most 30 an hour, one at a time; a credential that does not authenticate answers 401 and is never sent on without an account. source names the sender and defaults to agent. contact is an optional email address for a reply. Over a limit answers 429 feedback_rate_limited with Retry-After. The body must keep coming: it may wait at most a minute in all for each 4 KiB, and the request at most 15 minutes, or it is ended with 408 request_body_timeout; send it again.

## Authorization

- A Cool Computers API key, user access token, or claimed agent access token in the Authorization header. Follow https://www.cool.computer/auth.md for agent registration and https://www.cool.computer/authentication.md for direct user credentials.
- No credential: the request is also answered without one.

## Request body

Required.

- `application/json` (object)
  - `message` (string, pattern `\S`, 1 to 4000 characters, required): The feedback, 1-4000 characters after surrounding whitespace is trimmed.
  - `source` (string, pattern `^[a-z0-9_-]{1,32}$`): Who sends it, such as agent, cli or web. Defaults to agent.
  - `contact` (string, email, at most 254 characters): An email address for a reply.

## Responses

- `201`: The feedback was received.
  - `application/json` (object)
    - `id` (integer, at least 1, required)
    - `received` (true, required)
- `400`: Bad Request. `invalid_feedback`: the detail names the field to fix; `invalid_body`: the JSON is malformed or has an unknown field.
- `401`: Unauthorized.
- `413`: Payload Too Large. The body is larger than 64 KiB.
- `415`: Unsupported Media Type. Send the body with Content-Type: application/json.
- `429`: Too Many Requests. If the problem code is api_request_rate_exceeded, wait for Retry-After seconds; feedback_rate_limited means the sender's hourly feedback limit was reached, and Retry-After says when it sends again; feedback_busy means too much feedback is being sent at once; wait for Retry-After seconds.
- `500`: Internal Server Error.
- `default`: A machine-readable API error with a stable code and recovery instruction.

An error is an `application/problem+json` document with a stable `code`; [API errors](/docs/api-reference/errors) says how to handle one.

## Example

```sh
curl -X POST "https://api.cool.computer/api/feedback" \
  -H "authorization: Bearer $TOKEN" \
  -H "content-type: application/json" \
  --data '{"message":"string"}'
```
