Skip to main content

Endpoints

MethodPathAuth 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

GET /api/comments

Returns a paginated list of all comments, including their nested replies. Auth: None required.

Query Parameters

searchTerm
string
Optional search string to filter comments by content. Defaults to an empty string (returns all).
page
integer
Page number for pagination. Defaults to 1.

Response Fields

status
boolean
Indicates whether the request was successful.
statusCode
integer
HTTP status code of the response.
message
string
Human-readable message describing the result.
data
array
List of comment objects.

Example

curl -X GET "https://api.meetpoint.com/api/comments?page=1"

GET /api/comments/

Returns a single comment by its UUID, including its replies. Auth: None required.

Path Parameters

id
string (UUID)
required
The unique identifier of the comment.

Response Fields

data
object
The comment object.

Example

curl -X GET "https://api.meetpoint.com/api/comments/3fa85f64-5717-4562-b3fc-2c963f66afa6"

POST /api/comments

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

userId
string
The ID of the user posting the comment. Typically resolved from the authenticated token.
eventId
string (UUID)
required
The ID of the event to comment on.
content
string
required
The text content of the comment. Cannot be empty.
parentId
string (UUID)
Optional. The ID of an existing comment to reply to. Omit or set to null for a top-level comment.

Response Fields

data
object
The newly created comment object.

Example — top-level 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!"
  }'

Example — reply to an existing 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": "Me too!",
    "parentId": "a1b2c3d4-1234-5678-abcd-ef1234567890"
  }'

PUT /api/comments/

Updates the content of an existing comment. Auth: Bearer token required. Roles: USER, ADMIN, or ORGANIZER.

Path Parameters

id
string (UUID)
required
The unique identifier of the comment to update.

Request Body

content
string
required
The updated text content of the comment.

Response Fields

data
object
The updated comment object.

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."
  }'

DELETE /api/comments/

Deletes a comment and its replies. Auth: Bearer token required. Roles: USER, ADMIN, or ORGANIZER.

Path Parameters

id
string (UUID)
required
The unique identifier of the comment to delete.

Response Fields

data
object
The deleted comment object.

Example

curl -X DELETE "https://api.meetpoint.com/api/comments/3fa85f64-5717-4562-b3fc-2c963f66afa6" \
  -H "Authorization: Bearer <token>"

Build docs developers (and LLMs) love