v52

OpenAPI 3.1.0raw.githubusercontent.com2026-07-311,1941,9384.1 MB
Comments

Post a comment on a DIR

Post a customer comment on a DIR (for example, to respond to reviewer notes). Send only content (1–5000 chars) and an optional parent_comment_id; the server sets the comment type, visibility, and author automatically. The enterprise is resolved server-side from the DIR id.

post/dir/{dir_id}/comments

Path parameters

dir_idstring uuid required
Example:16635d38-75a6-4481-82e8-69af60e05011

The DIR id. Lowercase UUID.

Request body

contentstring required

Comment body. 1–5000 characters.

parent_comment_idstring uuid

Optional parent comment id to thread this reply under.

Example request

{
  "content": "Re-uploaded the logo as a 256×256 BMP. Please re-review."
}

Response

Comment created.

Example response

{
  "data": {
    "author_role": "customer",
    "content": "Please re-upload a clearer scan of the certificate.",
    "created_at": "2026-04-27T00:42:44.305835Z",
    "entity_type": "dir",
    "id": "30bbd13c-1f3a-47c0-8fa6-718835917b2f",
    "visibility": "customer"
  }
}