Endpoints
Method Path Auth Required GET /api/commentsNone (public) GET /api/comments/{id}None (public) POST /api/commentsUSER, ADMIN, or ORGANIZER PUT /api/comments/{id}USER, ADMIN, or ORGANIZER DELETE /api/comments/{id}USER, ADMIN, or ORGANIZER
Returns a paginated list of all comments, including their nested replies.
Auth: None required.
Query Parameters
Optional search string to filter comments by content. Defaults to an empty string (returns all).
Page number for pagination. Defaults to 1.
Response Fields
Indicates whether the request was successful.
HTTP status code of the response.
Human-readable message describing the result.
List of comment objects. Unique identifier of the comment.
ID of the user who authored the comment.
Display name of the author.
Membership details for the author. See Memberships for the object shape. ID of the event the comment belongs to.
Text content of the comment.
Timestamp when the comment was published.
ID of the parent comment if this is a reply, otherwise null.
Nested list of reply comment objects with the same shape.
Example
curl -X GET "https://api.meetpoint.com/api/comments?page=1"
Returns a single comment by its UUID, including its replies.
Auth: None required.
Path Parameters
The unique identifier of the comment.
Response Fields
The comment object. Unique identifier of the comment.
ID of the comment author.
Display name of the author.
Membership details for the author.
ID of the associated event.
Title of the associated event.
Text content of the comment.
Timestamp when the comment was published.
ID of the parent comment if this is a reply, otherwise null.
List of nested reply objects with the same shape.
Example
curl -X GET "https://api.meetpoint.com/api/comments/3fa85f64-5717-4562-b3fc-2c963f66afa6"
Creates a new comment on an event. To post a reply, set parentId to the UUID of the comment being replied to.
Auth: Bearer token required. Roles: USER , ADMIN , or ORGANIZER .
Request Body
The ID of the user posting the comment. Typically resolved from the authenticated token.
The ID of the event to comment on.
The text content of the comment. Cannot be empty.
Optional. The ID of an existing comment to reply to. Omit or set to null for a top-level comment.
Response Fields
The newly created comment object. Unique identifier of the new comment.
Display name of the author.
Membership details for the author.
Text content of the comment.
Timestamp of publication.
Parent comment ID if this is a reply, otherwise null.
Empty array for a new comment.
curl -X POST "https://api.meetpoint.com/api/comments" \
-H "Authorization: Bearer <token>" \
-H "Content-Type: application/json" \
-d '{
"userId": "user-id-string",
"eventId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"content": "Looking forward to this event!"
}'
curl -X POST "https://api.meetpoint.com/api/comments" \
-H "Authorization: Bearer <token>" \
-H "Content-Type: application/json" \
-d '{
"userId": "user-id-string",
"eventId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"content": "Me too!",
"parentId": "a1b2c3d4-1234-5678-abcd-ef1234567890"
}'
Updates the content of an existing comment.
Auth: Bearer token required. Roles: USER , ADMIN , or ORGANIZER .
Path Parameters
The unique identifier of the comment to update.
Request Body
The updated text content of the comment.
Response Fields
The updated comment object. Unique identifier of the comment.
Display name of the author.
Membership details for the author.
Original publication timestamp.
Parent comment ID if a reply, otherwise null.
Nested replies of the comment.
Example
curl -X PUT "https://api.meetpoint.com/api/comments/3fa85f64-5717-4562-b3fc-2c963f66afa6" \
-H "Authorization: Bearer <token>" \
-H "Content-Type: application/json" \
-d '{
"content": "Updated: I cannot make it after all."
}'
Deletes a comment and its replies.
Auth: Bearer token required. Roles: USER , ADMIN , or ORGANIZER .
Path Parameters
The unique identifier of the comment to delete.
Response Fields
The deleted comment object. Unique identifier of the deleted comment.
Display name of the author.
Membership details for the author.
Text content of the deleted comment.
Original publication timestamp.
Parent comment ID if a reply, otherwise null.
Nested replies that were also deleted.
Example
curl -X DELETE "https://api.meetpoint.com/api/comments/3fa85f64-5717-4562-b3fc-2c963f66afa6" \
-H "Authorization: Bearer <token>"