comments

Create a comment.

Support messages are deduplicated: an identical message from the same author on the same ticket within a short window returns the original comment with a 200 instead of creating a second one, and a 409 while a concurrent request is still creating it.

post/api/projects/{project_id}/comments/

Request

  • Base URL: https://us.posthog.com
  • URL: https://us.posthog.com/api/projects/{project_id}/comments/
  • Auth: HTTP bearer

Path parameters

project_idstring required

Project ID of the project you're trying to access. To find the ID of the project, make a call to /api/projects/.

Request body

idstring uuid required
scopestring
item_contextunknown
deletedboolean nullable
mentionsinteger[]
slugstring
is_taskboolean

Whether this comment is an actionable task that can be marked complete. Tasks render with a checkbox in the UI and can be filtered as a separate kind. Cannot be set on replies (source_comment) or emoji reactions. Immutable after creation.

contentstring nullable
rich_contentunknown
versioninteger required
created_atstring date-time required
item_idstring nullable
completed_atstring date-time nullable required

ISO timestamp when the task was marked complete. Only meaningful when is_task is true. Read-only — toggled via the /complete and /reopen actions, not via PATCH.

source_commentstring uuid nullable

Response

An identical support message was already created by a recent request. The original comment is returned and nothing new is written.

idstring uuid required
scopestring
item_contextunknown
deletedboolean nullable
mentionsinteger[]
slugstring
is_taskboolean

Whether this comment is an actionable task that can be marked complete. Tasks render with a checkbox in the UI and can be filtered as a separate kind. Cannot be set on replies (source_comment) or emoji reactions. Immutable after creation.

contentstring nullable
rich_contentunknown
versioninteger required
created_atstring date-time required
item_idstring nullable
completed_atstring date-time nullable required

ISO timestamp when the task was marked complete. Only meaningful when is_task is true. Read-only — toggled via the /complete and /reopen actions, not via PATCH.

source_commentstring uuid nullable

Changes

No recorded changes to this operation across all 1 revision of this API.