Handle Entity Report

Resolve an entity report within a space

PATCH /:projectId/api/v7/spaces/:spaceId/reports/entity/:reportId

Handle Entity Report

cURL

curl --request PATCH \
  --url https://api.replyke.com/api/v6/:projectId/api/v7/spaces/:spaceId/reports/entity/:reportId \
  --header 'Content-Type: application/json' \
  --data '
{
  "entityId": "<string>",
  "actions": [
    "<string>"
  ],
  "summary": "<string>",
  "userId": "<string>",
  "reason": "<string>"
}
'

Resolves a filed report against an entity in a space. Requires the caller to be a moderator or admin of that space.

Path Parameters

spaceId · string · required

UUID of the space.

reportId · string · required

UUID of the entity report to resolve.

Body Parameters

entityId · string · required

UUID of the reported entity. Used when performing remove-entity.

actions · string[] · required

One or more actions to take. Must contain at least one value. Available actions:

• "remove-entity" — marks the entity as removed via moderation
• "ban-user" — bans the target user from the space (requires userId and reason)
• "dismiss" — dismisses the report without action (requires summary; cannot be combined with other actions)

summary · string

Summary of the action taken. Required when using dismiss or any non-dismiss action.

userId · string

UUID of the user to ban. Required when ban-user is included in actions.

reason · string

Reason for the ban. Required when ban-user is included in actions.

Response

Returns 201 Created:

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

Error Responses

Report Not Found — 404

{ "error": "Report not found", "code": "report/not-found" }

Report Not in Space — 404

{ "error": "Report does not belong to this space", "code": "report/not-found-in-space" }

Entity Not Found — 404

{ "error": "Entity not found", "code": "report/entity-not-found" }

Entity Not in Space — 404

{ "error": "Entity does not belong to this space", "code": "report/entity-not-in-space" }

User Not Found — 404

{ "error": "User not found in this project", "code": "report/user-not-found" }

User Not a Member — 404

{ "error": "User is not a member of this space", "code": "space/member-not-found" }

Invalid Action Combination — 400

{ "error": "Cannot combine 'dismiss' with other actions", "code": "report/invalid-actions" }

Missing Required Fields — 400

{ "error": "Summary is required for dismissing a report", "code": "report/missing-fields" }

Also returned when ban-user is used without userId or reason:

{ "error": "userId and reason are required for banning a user", "code": "report/missing-fields" }