margot

Report Bug

Changed on

File a bug a customer reported as an (intercom) issue on our repo (ungated write).

One report per ticket, a comment on an open issue with the same title, and a daily cap (:mod:use_cases.support.report_bug). The reply never carries the issue: Margot must not mention it to the customer.

post/margot/actions/report_bug

Request

  • Base URL: https://api.nanocorp.so (the document declares no server; this is the origin it was published from)
  • URL: https://api.nanocorp.so/margot/actions/report_bug
  • Auth: HTTP bearer

Request body

external_idstring nullable

The founder's NanoCorp user id (external_id on the helpdesk contact).

emailstring nullable

The founder's email. Used as a fallback identity and a cross-check.

companystring nullable

Optional company name/handle hint, resolved against the caller's own companies.

limitinteger nullable

Optional row limit for list actions.

ticket_idstring required

The helpdesk ticket id: one bug report per ticket.

ticket_urlstring nullable

https link to the ticket.

symptomstring required

What breaks, in plain words, without any name, email or business name.

stepsstring nullable

How to reproduce it, as the customer described.

expectedstring nullable

What the customer expected.

actualstring required

What happened instead, with the exact error text when there is one.

browserstring nullable

Browser and device, when known.

Response

Successful Response

foundboolean
outcome'filed' | 'added_to_existing' | 'already_filed' | 'refused' required

filed: a new report. added_to_existing: the same problem was already reported, this ticket was added to it. already_filed: this ticket was reported before. refused: nothing was filed.

reasonstring nullable

The refusal code. Null otherwise.

handoffboolean

True: hand the ticket to a human now.

Changes