---
title: "Create a comment."
method: POST
path: "/authoring/v1/comments"
tags: ["Authoring comments"]
---

# Create a comment.

`POST /authoring/v1/comments`

Use the /comments endpoint to create a comment. You must provide a message and a target to create the comment.<br />User roles: admin, manager, editor

## Request body

- object
  - `message` string, required — The actual comment message.
  - `target` object, required
    - `id` string, required — The id of the item that the comment is associated with.
    - `classification` 'asset' | 'content', required — The classification of the item that the comment is associated with.

## Response `201`

Successfully created a comment for an item.

- object
  - `creatorId` string, required — The ID of the user that created the commment.
  - `id` string, required — The id of the comment.
  - `rev` string, required — The revision of the comment.
  - `message` string, required — The actual comment message.
  - `created` string, date-time, required — ISO-8601 formatted date.
  - `target` object, required
    - `id` string, required — The id of the item that the comment is associated with.
    - `classification` 'asset' | 'content', required — The classification of the item that the comment is associated with.
  - `threadId` string, required — The id string of the thread that this comment belongs to.
  - `classification` string, required — The comment's classification.
  - `kind` string[], required — The "kind" of comment that this is. By default, all comments created by users are "user" comments.
  - `creator` string, required — Display name of the user who created this comment.
  - `lastModifier` string, required — The display name of the user who last edited the comment.
  - `lastModifierId` string, required — The ID of the user who last edited the comment.
  - `lastModified` string, required — The ISO-8601 timestamp that the comment was last modified.
  - `resolved` boolean, required — Used for resolving comments during a review. This property is false by default and changes to true when the comment is resolved.

## Other responses

- `400` — The required parameters are missing or invalid. Provide valid parameters to create a comment.
- `429` — Too Many Requests, the server has reached a limit, the request must be sent again at a later time.
- `503` — Unable to create the comment as the service is unavailable. Try again later.
- `default` — Unexpected error.

---

[API](https://skmtc.net/goacoustic/apis/acoustic-content-api.md) · [All operations](https://skmtc.net/goacoustic/apis/acoustic-content-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/goacoustic/acoustic-content-api/revisions/677305266d89/schema)