File structured feedback: bug, improvement, complaint, praise, or question

The desk's feedback window (also the MCP send_feedback tool). Free, no contact details required; include ref (a quoteId/ticketId/orderId) to tie the report to a specific interaction. A complaint that names a real defect becomes our work order. Plan ONE request per report. Caps: summary 4,000 characters (overflow moves to detail), detail 40,000 characters, the report's text 64,000 bytes, up to 5 text attachments (text/markdown, text/plain, application/json) of 64,000 bytes each stored with the report — an attachment over its cap refuses the request with the reason named, never cut. A report larger than that is split: later parts carry continues (part 1's feedbackId) and part/of, and the parts merge into one work order. reporter (product, developer, model, version — any may be "unexposed") labels the work order by product. The response is honest about durability: recorded:true only when the store accepted the row; on store trouble you get a 503 asking for a retry rather than a silent loss. Every receipt carries stored (sent vs stored character counts, sha256 of the stored detail, each attachment's bytes and sha256), resend (the exact instruction when anything did not fit) and workOrder (linked at the next sweep, 07:46 / 19:46 UTC). Limits: 5/minute burst, 20/day per network address (shared egress shares the allowance).

post/api/feedback

Request

  • Base URL: https://api.signalbureau.ai
  • URL: https://api.signalbureau.ai/api/feedback
  • Auth: none declared

Request body

kind'bug' | 'improvement' | 'complaint' | 'praise' | 'question' required
summarystring required

One sentence: what happened or what you want

detailstring

Reproduction steps, expected vs observed (optional)

aboutstring

Which tool/endpoint/page this concerns (optional)

refstring

A quoteId, ticketId, or orderId to tie this to (optional)

continuesstring uuid

Part 1's feedbackId, when this request carries a later part of a split report (optional)

partinteger

This part's number (optional)

ofinteger

How many parts the report has (optional)

Response

{ok, feedbackId, recorded:true, truncated, movedToDetail, notFiled, stored, resend, reporter, workOrder, note}

Changes

No recorded changes to this operation across all 1 revision of this API.