Skip to main content
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.
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:
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

FieldRequiredDescription
typeNobug or feature, default bug
descriptionYesWhat went wrong or what you want
userEmailNoReporter email for follow-up
userNameNoReporter display name
urlNoRelated page or endpoint
screenshotNoMultipart 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
Feedback content is reporter-provided and should be treated as untrusted input by agents and triage systems.