Comments is currently an internal API. The endpoints below document the planned public v1 shape. Will be promoted to public v1 API in a future release.

List Comments

GET/v1/comments

Returns all published comments for a given article.

Query parameters

article_idstringqueryrequired

UUID of the article to fetch comments for.

limitintegerquerydefault: 20

Results per page (max 100).

offsetintegerquerydefault: 0

Pagination offset.

Response fields

dataArray<Comment>

The page of comments. Each item includes id, article_id, author, body, and created_at.

totalinteger

Total number of comments for the article.

limitinteger

Results per page.

offsetinteger

Pagination offset.

curl "https://api.misar.io/blog/v1/comments?article_id=550e8400-e29b-41d4-a716-446655440000"

{
  "data": [
    {
      "id": "uuid",
      "article_id": "uuid",
      "author": {
        "username": "janedoe",
        "display_name": "Jane Doe",
        "avatar_url": "https://supabase-blog.misar.io/storage/v1/object/public/avatars/janedoe.jpg"
      },
      "body": "Great article! The section on streaming was especially helpful.",
      "created_at": "2026-04-16T10:30:00Z"
    }
  ],
  "total": 14,
  "limit": 20,
  "offset": 0
}

Create a Comment

POST/v1/comments

Posts a new comment on an article. Requires authentication with Authorization: Bearer mbk_YOUR_API_KEY.

Request body

article_idstringbodyrequired

UUID of the article to comment on.

bodystringbodyrequired

Comment text (1–2000 chars).

Response fields

idstring

Unique identifier of the created comment.

article_idstring

UUID of the article the comment belongs to.

bodystring

The comment text.

created_atstring

ISO 8601 creation time.

curl -X POST "https://api.misar.io/blog/v1/comments" \
  -H "Authorization: Bearer mbk_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"article_id":"550e8400-e29b-41d4-a716-446655440000","body":"Excellent write-up!"}'

{
  "article_id": "uuid",
  "body": "Great article! The section on streaming was especially helpful."
}

{
  "id": "uuid",
  "article_id": "uuid",
  "body": "Great article! The section on streaming was especially helpful.",
  "created_at": "2026-04-16T10:30:00Z"
}

Delete a Comment

DELETE/v1/comments/:id

Deletes a comment you own. Requires authentication.

Path parameters

idstringpathrequired

UUID of the comment to delete.

(empty response body)

Status codes

400 — Missing article_id or invalid body length
401 — Invalid or missing API key (create/delete only)
403 — Attempting to delete a comment you do not own
404 — Article or comment not found