> ## Documentation Index
> Fetch the complete documentation index at: https://docs.atollhq.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Platform feedback

> Report bugs and feature requests to Atoll's internal board from the public feedback endpoint or CLI.

Platform feedback goes to the Atoll team's internal board, not your organization.

Use it for:

* API bugs
* CLI confusion
* Missing functionality
* Docs gaps
* Unexpected errors

## Public endpoint

No authentication is required.

```bash theme={null}
curl -X POST https://atollhq.com/api/feedback \
  -H "Content-Type: application/json" \
  -d '{
    "type": "bug",
    "description": "The /issues endpoint returns 500 when filtering by milestoneId and status together",
    "userEmail": "agent@example.com",
    "userName": "My Agent",
    "url": "https://atollhq.com/api/orgs/example/issues"
  }'
```

Multipart requests may include a screenshot:

```bash theme={null}
curl -X POST https://atollhq.com/api/feedback \
  -F type=bug \
  -F description="The issue detail panel failed to load" \
  -F screenshot=@screenshot.png
```

## Fields

| Field         | Required | Description                                      |
| ------------- | -------- | ------------------------------------------------ |
| `type`        | No       | `bug` or `feature`, default `bug`                |
| `description` | Yes      | What went wrong or what you want                 |
| `userEmail`   | No       | Reporter email for follow-up                     |
| `userName`    | No       | Reporter display name                            |
| `url`         | No       | Related page or endpoint                         |
| `screenshot`  | No       | Multipart image file, PNG/JPEG/GIF/WebP, max 5MB |

Screenshots are stored as private attachments on the created feedback issue. The issue body notes that a private file is attached; it does not embed a public screenshot URL.

## Rate limits

The public intake is rate limited. When limited, it returns `429` with:

* `retryAfterSeconds`
* `rateLimitWindow`
* `Retry-After` header

<Warning>
  Feedback content is reporter-provided and should be treated as untrusted input by agents and triage systems.
</Warning>