Upvote Comment
Endpoint
URL: /:projectId/comments/:commentId/upvote
Method: PATCH
Authentication Required: Yes
Description
Upvotes a comment on behalf of the authenticated user.
- Adds the user’s ID to the comment’s
upvotesarray. - Removes the user from
downvotesif previously downvoted. - Increases the reputation of the comment author.
- Sends a notification to the comment’s author.
Request
Path Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
commentId | string | Yes | The ID of the comment to upvote. |
Headers
| Header | Type | Required | Description |
|---|---|---|---|
Authorization | string | Yes | Bearer token for authenticated users. |
Response
Success Response (200 OK)
Returns the updated comment:
{
"id": "comment-123",
"entityId": "entity-456",
"upvotes": ["user-789"],
"downvotes": [],
"content": "Great insight!",
...
}Error Responses
Missing Comment ID (400 Bad Request)
{
"error": "Missing required data",
"code": "comment/missing-data"
}Not Found (404 Not Found)
{
"error": "Comment not found",
"code": "comment/not-found"
}Already Upvoted (409 Conflict)
{
"error": "User has already upvoted this comment",
"code": "comment/already-upvoted"
}Server Error (500 Internal Server Error)
{
"error": "Internal server error.",
"code": "comment/server-error",
"details": "[error message]"
}Notes
- If the user already upvoted the comment, a
409 Conflicterror is returned. - Reputation is awarded to the comment’s author.
- A notification is triggered to inform the comment’s author of the upvote.
- The user’s ID is removed from
downvotesif previously present.