Post a new comment to the indicated content item's comment thread. Comments may optionally be nested one level deep; attempting to nest deeper than that is an error.
POST /api/v1/content/39b7a825-a8b6-4cf9-9233-d9ae698830ce/comments HTTP/1.1
Authorization: Bearer ...
Content-Type: application/json
{
"body": "great game A++++++"
}
----------------------------------------
HTTP/1.1 204 No Content
ETag: W/"a-bAsFyilMr4Ra1hIU5PyoyFRunpI"
Location: /comment/32Authentication is required. Anyone is allowed to comment as long as the content item is accessible under the special rules noted in GET content/{contentId}.
| Name | Description | Value |
|---|---|---|
| contentId | the ID of the content as a GUID with dashes | string |
| Name | Description | Value |
|---|---|---|
| body | the text content of the comment to post | string |
| parentId | the ID of the parent comment under which to nest this comment; omit this property for a root-level comment optional | number |
Successful responses are code 204. Besides the standard format errors, code 400 will also be returned if the user is attempting to nest comments beyond the allowed nesting limit. Other error responses are standard.
| Name | Description | Value |
|---|---|---|
| Location | the URI of the inserted comment which contains its generated ID | string |
NONE