Skip to main content
POST
api
/
v2
/
user-feedback
Create User Feedback
curl --request POST \
  --url https://api.prd.realitydefender.xyz/api/v2/user-feedback \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "requestId": "<string>",
  "label": "<string>",
  "feedbackCategory": "<string>",
  "comment": "<string>"
}
'
​
requestId
string
The media result identifier (required). This is the requestId returned when a file was processed; you can also obtain it from the Media Detail response or the web app when viewing a result.
​
label
string
Your label for the content (required). One of: REAL, SYNTHETIC, MANIPULATED, UNKNOWN.
​
feedbackCategory
string
The type of feedback (required). One of: FALSE_POSITIVE, FALSE_NEGATIVE, CONFIRMATION, OTHER.
​
comment
string
Optional free-text comment. If omitted, no comment is stored.
Submits user feedback for a completed scan result. The server records who submitted the feedback, links it to the result, and may trigger internal notifications. A successful request returns 201 Created with the created feedback record.
You may only submit feedback for a result you uploaded, for a result in your same organization, or, for certain roles, on behalf of your organization. If the requestId is unknown, the API returns 400. If you are not allowed to comment on that result, the API returns 403.

​
Authorization

You must include the x-api-key header in your request. The key must belong to a user with RealScan access to authenticate the request and properly attribute the feedback to the correct user and organization.

​
Errors

  • 400 Bad Request — No media result exists for the given requestId ("Media result does not exist!").
  • 403 Forbidden — The authenticated user cannot submit feedback for that result ("You are not authorized to create feedback for this media result!").

​
Sample request

curl -X POST \
  'https://api.prd.realitydefender.xyz/api/v2/user-feedback' \
  -H 'X-API-KEY: your-api-key-here' \
  -H 'Content-Type: application/json' \
  -d '{
    "requestId": "your-request-id",
    "label": "REAL",
    "feedbackCategory": "CONFIRMATION",
    "comment": "Looks correct in context."
  }'

​
Sample response

201 Created — body shape is similar to: 
{
  "id": "uuid",
  "userId": "user-id",
  "requestId": "your-request-id",
  "institutionId": "institution-id",
  "text": "Looks correct in context.",
  "category": "CONFIRMATION",
  "userName": "Jane Doe",
  "userEmail": "jane@example.com",
  "orgName": "Organization name",
  "mediaType": "VIDEO",
  "mediaViewUrl": "https://...",
  "mediaSource": "API",
  "label": "REAL",
  "createdAt": "2025-01-15T12:00:00.000Z"
}
Field presence may vary slightly depending on the user profile and the stored result; the text field is only populated if a comment is included in the request.