Report a message in an application conversation

POST

/v1/job-messages/{id}/reports

curl --request POST \
  --url https://api.gampeon.com/v1/job-messages/1/reports \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{ "category": "scam", "explanation": "example", "reporterName": "example", "reporterEmail": "hello@example.com", "goodFaith": true }'

• Production

Only people in the conversation can report, never their own message. A copy of the message is kept with the report.

Not available with access tokens.

Rate limit: 10 per hour per IP.

Authorizations

• session

Parameters

Path Parameters

id

required

integer

>= 1

Message ID

Request Body^required

Media typeapplication/json

object

category

required

string

Allowed values: scam illegal_work child_safety harassment hate_speech spam copyright other

explanation

required

string

>= 20 characters <= 5000 characters

reporterName

string

>= 2 characters <= 120 characters

reporterEmail

string format: email

<= 254 characters

goodFaith

required

Confirms the report is made in good faith

Responses

201

Report received (200 if you already reported it)

Media typeapplication/json

object

reportId

required

string

status

required

Allowed value: open

Example

{
  "status": "open"
}

400

Error codes: invalid_field

Media typeapplication/json

object

error

required

Machine-readable error code, for example not_found or rate_limited.

string

message

Human-readable detail. Only present for some errors.

string

Example ^generated

{
  "error": "example",
  "message": "example"
}

401

Error codes: unauthorized

Media typeapplication/json

object

error

required

Machine-readable error code, for example not_found or rate_limited.

string

message

Human-readable detail. Only present for some errors.

string

Example ^generated

{
  "error": "example",
  "message": "example"
}

403

Error codes: token_not_allowed

Media typeapplication/json

object

error

required

Machine-readable error code, for example not_found or rate_limited.

string

message

Human-readable detail. Only present for some errors.

string

Example ^generated

{
  "error": "example",
  "message": "example"
}

404

Error codes: not_found

Media typeapplication/json

object

error

required

Machine-readable error code, for example not_found or rate_limited.

string

message

Human-readable detail. Only present for some errors.

string

Example ^generated

{
  "error": "example",
  "message": "example"
}

409

Error codes: own_message

Media typeapplication/json

object

error

required

Machine-readable error code, for example not_found or rate_limited.

string

message

Human-readable detail. Only present for some errors.

string

Example ^generated

{
  "error": "example",
  "message": "example"
}

422

Error codes: good_faith_confirmation_required

Media typeapplication/json

object

error

required

Machine-readable error code, for example not_found or rate_limited.

string

message

Human-readable detail. Only present for some errors.

string

Example ^generated

{
  "error": "example",
  "message": "example"
}

429

Limit: 10 per hour per IP. Error codes: rate_limited

Media typeapplication/json

object

error

required

Machine-readable error code, for example not_found or rate_limited.

string

message

Human-readable detail. Only present for some errors.

string

Example ^generated

{
  "error": "example",
  "message": "example"
}