---
id: action-item-comment-create
title: "Add a comment"
description: "Add a comment to an action item."
sidebar_label: "Add a comment"
hide_title: true
hide_table_of_contents: true
api: eJzFV21v2zYQ/iuH+9IWUBylTbtNn+ZmHZYBQ4vE27rFRkqLJ4utRKoklcQ1/N+HI2VbtpOmKdYtHxxbIu/l4fMc7xYoyeVWNV4ZjRkOpQQBualr0h68AaFB5PwSlKd6MNZjPSppvUK0vjQWlANRXYu5A0ceCmtq8CWFt6S9yoUnCa0j+8jBlIQlC958ID0Ya0zQNGQF+ziVmGF0d8nuLjs3WW5JeMIEvZg5zC5wGGM69VTDSVyEkwQd5a1Vfo7ZxQKjo2HrS8wuJstJgo2woiZP1oUFijNuhC8xQS1qwgyVxARdXlItMFugnzf81Hmr9AyXCVr62CpLEjNvW0p20GNkemjB6U8DTJBuRN1UbOfmr0/fff/DcHoiXxXIAbE5cv6lkXN2t2s9N9pzZtkCRdNUjKMy+vC9Y2+L/TjN9D3lHvthXqyNcP6WofaKHG/qWd/O87a01pSgGz+A87ZpjPUOfhP2gzTXejvPM7pSdE0ykqAoKOfzt+RMa3NyAxiVyoErTVtJmBI0VhmrvPpEEgpjwzZNNx5cY5X2A1yGP87LNUa7GP/T9Ij/3RJrYItcxcyxfTWS25Ap+TC0dgmQ1/7o6bMVARKM8nmYzbhn2+57oenH7ucgNzXb/vrj3TL94KNKsMP/UtzqvDC25jcohacDr2rai+iEDbCK+K3zom62Y3qaPn1xkB4fpC9GR8fZszRL00Gapn8jc8QrHxatykJkzvHbt/tkOakUJ03WGgtrboFsiUuf0leiUhKUblqfQK2cU3oGmyKSgLHQ6nggARGR5+RcqJJnUdoQbMRsgh/HdRAESFUUZNm9K0VD2Vi/e/eO+TjWi7EGGAfgxpjBGP9Y23jFJsaYxBXRIK+5WMAYa3JOzLo9UyPnULfOQymuCFYVATpCz+GRpILsZau9qh6NEZaTsV6GKEJR/mLFGE2vi1BPd7WzDfa5F1oKK3fgHuyUK+eFb92JkUyLsBSTVWb7Nay3ekM1pT3NyO5F8Mto9AbiDsiNJHhMg9kggeM05Y8j/njGH8dPtvh2nKZBT1tO7hDTbyIvlaYDS0KKaUVdtrx5m8NTIS+78s+aiZnea/68NNZD7xmYImgwuuHN225eCglnGzcrIO91NJRS8VdRgSQvVOVATE3rN852y0TkGFP+WjioRcVCJwkhe+2F0iTXmtqIKBT35D7y3KWmO2kUzHWwun3eRG/7IGwS2tHc+ox621FYK+aYIF/27v7b4zPg93hxr26jYrs7cRLL2/Pbyts52Suye+VNaRnUrGfc3SnnWgKutSXB8M0pOBWp+q80H/+lmi01lhz3m3oWsnEN5apQObgeEFu0ff4AZQ+hvlvb4EvhgfvcWbgKXAwg+i2Eqlq7I0xOy2pRXcZFl7TFsi8JZ2oVFQmUbS30JqYH1IbTLgToiLIm+jerEkMNraabJjaEMS6T561lhnccjHiser4QjS8NTwaNcUFU3LFneNgbFA4XSi4PuybGcQsfjMQ2v7UVZlh637js8FA0aqDbqmoq4blCxXapNzucM7EjH/sTxBoKNrQaEoJgwyJMui8/r9qbX/8chX6EBXO26fNfrcDoNeDfoGFOUOnCsBfGIZ7W0SAdpLjpkHpDlOMdjG8tgrq7cWhrHNw9/X4C/8vc2B0I96yHTSWU5iTCaS86klz0p0lMMAvz3ZonkwRL5lR2gYvFVDj63VbLJT/+2JLlKXKS4JWwipUVuCSV4+8Ss0JUbncA7CPy+Kwrg0/g9rHw1uhXF4vma+VKVC3/wgQ/0DxOp8vJMsGShCQbAoovTqLbg1G89VYb9+o2X7RxxzDPqfGfXTvpSe/N6/MRU7wbVOtQMdGKa6734joGaQIMQTnh2QIroWdtqCQYbS67oaenpx399DvJbRgWi7hixAxYLteoBEZguAn/Af2i2u8=
sidebar_class_name: "post api-method"
info_path: docs/api/action-items
custom_edit_url: null
---

import MethodEndpoint from "@theme/ApiExplorer/MethodEndpoint";
import ParamsDetails from "@theme/ParamsDetails";
import RequestSchema from "@theme/RequestSchema";
import StatusCodes from "@theme/StatusCodes";
import OperationTabs from "@theme/OperationTabs";
import TabItem from "@theme/TabItem";
import Heading from "@theme/Heading";

<Heading
  as={"h1"}
  className={"openapi__heading"}
  children={"Add a comment"}
>
</Heading>

<MethodEndpoint
  method={"post"}
  path={"/action_item/{id}/comments"}
  context={"endpoint"}
>
  
</MethodEndpoint>



Add a comment to an action item.

The comment author is always set from the authenticated user's bearer token.


<Heading
  id={"request"}
  as={"h2"}
  className={"openapi-tabs__heading"}
  children={"Request"}
>
</Heading>

<ParamsDetails
  parameters={[{"in":"path","name":"id","schema":{"type":"string"},"required":true,"description":"The action item ID.","example":"xYz789AbCdEf"}]}
>
  
</ParamsDetails>

<RequestSchema
  title={"Body"}
  body={{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["content"],"properties":{"content":{"type":"string","description":"The comment text. Supports Markdown.","example":"Reviewed the affected resources. This should be prioritized for the next sprint."}}}}}}}
>
  
</RequestSchema>

<StatusCodes
  id={undefined}
  label={undefined}
  responses={{"201":{"description":"The created comment.","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","description":"The comment ID.","example":"cmt123AbCdEf"},"author":{"type":"string","description":"The comment author.","example":"jane@example.com"},"content":{"type":"string","description":"The comment text.","example":"This should be prioritized for the next sprint."},"created_at":{"type":"string","format":"date-time","description":"Creation timestamp.","example":"2026-04-06T14:30:00.000Z"}},"title":"Comment"}}}},"4XX":{"description":"Client error responses due to invalid input, missing parameters, or unauthorized access.\n\nRequest validation errors use a different shape:\n```json\n{\n  \"type\": \"ValidationError\",\n  \"errors\": [{ \"message\": \"body must have required property 'defer_until'\" }]\n}\n```\n","content":{"application/json":{"schema":{"oneOf":[{"type":"object","description":"Standard error response.","required":["statusCode","error","message"],"properties":{"statusCode":{"type":"integer","description":"HTTP status code (e.g., 400, 401, 403, 404).","example":400},"code":{"type":"string","description":"Machine-readable error code.","example":"bad_request"},"error":{"type":"string","description":"Short description of the error type.","example":"Bad Request"},"message":{"type":"string","description":"Additional details about the error.","example":"The request was malformed or contained invalid parameters."}}},{"type":"object","description":"Request validation error response.","required":["type","errors"],"properties":{"type":{"type":"string","example":"ValidationError"},"errors":{"type":"array","items":{"type":"object","properties":{"message":{"type":"string","example":"body must have required property 'until'"}}}}}}]}}}},"5XX":{"description":"Server error responses indicating an issue on the API side.","content":{"application/json":{"schema":{"type":"object","required":["statusCode","error","message"],"properties":{"statusCode":{"type":"integer","description":"HTTP status code representing the specific server error.","example":500},"code":{"type":"string","description":"A machine-readable error code that categorizes the server failure.","example":"internal_server_error"},"error":{"type":"string","description":"A brief, human-readable description of the error type.","example":"Internal Server Error"},"message":{"type":"string","description":"Additional details about the error.","example":"An unexpected error occurred on the server."}}}}}}}}
>
  
</StatusCodes>