Skip to content

Report a user

POST
/v1/reports
curl --request POST \
--url https://app.mondochat.io/v1/reports \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{ "reason": "Asked me to pay elsewhere", "user_id": "0199d6a0-1000-7000-8000-000000000002" }'

Reports a user the caller talks to. Takes a session token. A repeat report of the same user by the same reporter while the first is open is accepted and stored once. A report opens a moderation case of kind report and sends the report.created webhook. See https://docs.mondochat.io/guides/safety/.

Media typeapplication/json
ReportCreate

A report about a user the caller talks to.

object
conversation_id
Any of:
string format: uuid
reason
required
Reason

What the report is about.

string
>= 1 characters <= 1000 characters
user_id
required
User Id

The user to report.

string format: uuid

Successful Response

Media typeapplication/json

Example generated

example

Problem

Media typeapplication/problem+json

An RFC 9457 problem: the body of every error answer.

object
code
required

The stable error code to branch on, such as policy_denied.

string
detail

What went wrong this time, when there is more to say.

string | null
errors

For validation, one entry per invalid field.

Array<object>

One invalid field.

object
loc

The path to the field.

array
msg

What is wrong with it.

string
instance

The path of the request.

string
reason

For policy_denied and limit_reached, the rule or limit that refused the request; for forbidden, a short cause such as you_blocked; for banned, temporary when the ban expires.

string
status
required

The HTTP status code.

integer
title
required

A short summary of the problem.

string
type
required

A URL that names the problem, https://app.mondochat.io/problems/<code>.

string

Example

{
"code": "policy_denied",
"detail": null,
"instance": "/v1/conversations/0199d6a0-2000-7000-8000-000000000001",
"reason": "pins",
"status": 403,
"title": "Policy denied",
"type": "https://app.mondochat.io/problems/policy_denied"
}