Description

Vote that a user report is valid (upvote) or invalid (downvote). Each authenticated user may have at most one vote per report; submitting again updates the existing vote.

Authentication

Requires a Bearer token in the Authorization header or a token query parameter.

Path Parameters

• id: UUID of the report to vote on.

Request Body

• vote (Required): Either valid (upvote) or invalid (downvote).
• externalUserId (Optional): Opaque user identifier from your application.

Response

Returns the updated User Report object with refreshed upvoteCount / downvoteCount.

Error Responses

• 400 Bad Request: Invalid report id or vote value.
• 401 Unauthorized: Token is missing or invalid.
• 404 Not Found: Report does not exist.
• 410 Gone: Report has been deleted or expired.

Example Request
POST https://api.vectorcharts.com/api/v1/user-reports/550e8400-e29b-41d4-a716-446655440000/votes
Authorization: Bearer <token>
Content-Type: application/json

{
    "vote": "valid",
    "externalUserId": "app-user-abc123"
}

Example Response
Status Code: 200 OK
Response Body:
{
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "reportType": "hazard",
    "latitude": 42.36,
    "longitude": -71.05,
    "properties": {},
    "upvoteCount": 4,
    "downvoteCount": 1,
    "isOwner": false,
    "externalUserId": "app-user-abc123",
    "namespace": "public",
    "createdAt": 1718380800000,
    "updatedAt": 1718381000000,
    "expiredAt": null,
    "deletedAt": null
}