Create Report

Submit a content report for an entity or comment

POST /:projectId/api/v7/reports

Create Report

cURL

curl --request POST \
  --url https://api.replyke.com/api/v6/:projectId/api/v7/reports \
  --header 'Content-Type: application/json' \
  --data '
{
  "targetId": "<string>",
  "targetType": "<string>",
  "reason": "<string>",
  "details": "<string>"
}
'

Submits a report on an entity or comment. If a report already exists for the target, the authenticated user’s report is added to it (increments reporterCount). If the same user has already reported the same target, a 200 is returned without creating a duplicate.

Authentication required.

Body Parameters

targetId · string · required

The UUID of the entity or comment being reported.

targetType · string · required

The type of content being reported. One of: entity, comment.

reason · string · required

The reason for the report (e.g., “spam”, “harassment”, “misinformation”). Must not be empty.

details · string

Optional additional context or description provided by the reporter.

Response

Returns 201 Created when a new report is created:

{ "message": "Report submitted successfully", "code": "report/created" }

Returns 200 OK when an existing report is updated with a new reporter:

{ "message": "Report updated successfully", "code": "report/updated" }

Returns 200 OK when the user has already reported this target:

{ "message": "Report already registered by this user", "code": "report/already-reported" }

Error Responses

Target Not Found — 404

{ "error": "<targetType> not found", "code": "report/target-not-found" }

The error message reflects the reported type, e.g. "entity not found" or "comment not found".