Comments

Comment management

Get Comments by Blog

get

Retrieves all comments associated with a specific blog post.

Authorizations

bearerAuth

AuthorizationstringRequired

JWT Access Token obtained via login/register/refresh

Path parameters

blogIdstring · objectidRequired

ID of the blog post.

Responses

200

A list of comments for the blog.

application/json

401

Authentication information is missing or invalid (e.g., missing/expired token).

application/json

404

The specified resource was not found.

application/json

500

An unexpected error occurred on the server.

application/json

get

/comments/blog/{blogId}

HTTPcURLJavaScriptPython

GET /api/v1/comments/blog/{blogId} HTTP/1.1
Host: blog-api.codewithsadee.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "comments": [
    {
      "_id": "text",
      "blogId": "text",
      "userId": "text",
      "content": "text",
      "likesCount": 0,
      "createdAt": "2025-12-21T04:05:10.451Z",
      "updatedAt": "2025-12-21T04:05:10.451Z"
    }
  ]
}

Create Comment

post

Adds a new comment to a specific blog post. Increments comments count.

Authorizations

bearerAuth

AuthorizationstringRequired

JWT Access Token obtained via login/register/refresh

Path parameters

blogIdstring · objectidRequired

ID of the blog post.

Body

application/json

contentstring · max: 1000Required

The comment text

Responses

201

Comment created successfully.

application/json

400

Invalid input data provided. See errors object for details.

application/json

401

Authentication information is missing or invalid (e.g., missing/expired token).

application/json

404

The specified resource was not found.

application/json

500

An unexpected error occurred on the server.

application/json

post

/comments/blog/{blogId}

HTTPcURLJavaScriptPython

POST /api/v1/comments/blog/{blogId} HTTP/1.1
Host: blog-api.codewithsadee.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 18

{
  "content": "text"
}

{
  "comment": {
    "_id": "text",
    "blogId": "text",
    "userId": "text",
    "content": "text",
    "likesCount": 0,
    "createdAt": "2025-12-21T04:05:10.451Z",
    "updatedAt": "2025-12-21T04:05:10.451Z"
  }
}

Delete Comment

delete

Deletes a specific comment. Requires user to be author or admin. Decrements comments count.

Authorizations

bearerAuth

AuthorizationstringRequired

JWT Access Token obtained via login/register/refresh

Path parameters

commentIdstring · objectidRequired

ID of the comment.

Responses

204

Request successful, no response body.

401

Authentication information is missing or invalid (e.g., missing/expired token).

application/json

403

Access denied due to insufficient permissions.

application/json

404

The specified resource was not found.

application/json

500

An unexpected error occurred on the server.

application/json

delete

/comments/{commentId}

HTTPcURLJavaScriptPython

DELETE /api/v1/comments/{commentId} HTTP/1.1
Host: blog-api.codewithsadee.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

No content