---
title: "Post a Comment on a Request"
method: POST
path: "/v1/requests/{uuid}/comments"
tags: ["comments", "requests"]
---

# Post a Comment on a Request

`POST /v1/requests/{uuid}/comments`

## Path parameters

- `uuid` string, uuid, required

## Request body

- CommentCreate
  - `content` string, required
  - `mentioned_user_uuids` string[] — User UUIDs to mention and notify. Plain-text @Name text does not create mention notifications.

## Response `201`

The newly created Comment

- object
  - `data` CommentRead, required
    - `uuid` string, uuid, required
    - `content` string, required
    - `author_user_uuid` string, uuid, required
    - `created_at` string, date-time, required
    - `updated_at` string, date-time, required
    - `_links` CommentReadLinks, required
      - `self` HalLink, required
        - `href` string, uri, required
        - `title` string — A human-readable title for the link
        - `type` string, required — The content-type

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden (requires scopes `comments:write`)
- `429` — Too many requests

---

[API](https://skmtc.net/fieldguide/apis/fieldguide-api.md) · [All operations](https://skmtc.net/fieldguide/apis/fieldguide-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/fieldguide/fieldguide-api/revisions/6f6009a58cdd/schema)