Skip to main content
POST
Report Message
Submits a report flagging a message for review. The caller must be a member of the conversation and cannot report their own messages. If a report for this message already exists, the caller’s report is added to it (incrementing the reporter count). If the caller already reported this message, a 200 is returned without creating a duplicate.

Path Parameters

string
required
The ID of the conversation.
string
required
The ID of the message to report.

Body Parameters

string
required
The reason for the report (e.g. "spam", "harassment", "inappropriate").
string
Optional additional details about the report.

Response

Returns one of:
  • 201 Created — new report submitted: { "message": "Report submitted.", "code": "report/created" }
  • 200 OK — added to existing report: { "message": "Report updated.", "code": "report/updated" }
  • 200 OK — already reported by this user: { "message": "Report already registered by this user.", "code": "report/already-reported" }

Error Responses