---
title: "Post a comment on a DIR"
method: POST
path: "/dir/{dir_id}/comments"
tags: ["Comments"]
---

# Post a comment on a DIR

`POST /dir/{dir_id}/comments`

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.

## Path parameters

- `dir_id` string, uuid, required

## Request body

- DirCommentCreateRequest — Customer-facing comment body. The server forces `comment_type=customer_inquiry`, `visibility=customer`, and `author_role=customer`; clients cannot override these. `author_name` is dropped to prevent admin-impersonation.
  - `content` string, required — Comment body. 1–5000 characters.
  - `parent_comment_id` string, uuid — Optional parent comment id to thread this reply under.

## Response `201`

Comment created.

- CommentWrapped
  - `data` DirComment, required
    - `id` string, uuid
    - `entity_type` 'dir' — Resource the comment is attached to. Always `dir` on this endpoint.
    - `content` string
    - `visibility` 'customer' — Always `customer` on this endpoint - internal-only comments are filtered out.
    - `author_role` 'customer' | 'admin' — Who wrote the comment. `admin` covers the Telnyx vetting team.
    - `author_name` string, nullable — Display name of the author. May be `null`.
    - `comment_type` 'vetting_comment' | 'rejection_reason' | 'internal_note' | 'notification' | 'status_update' | 'customer_inquiry' | 'admin_response' — Comment categorisation. Customers post `customer_inquiry`. The Telnyx team posts `vetting_comment`, `rejection_reason`, `notification`, `status_update`, or `admin_response`. `internal_note` is filtered out of customer-visible responses.
    - `created_at` string, date-time

## Other responses

- `default` — An error occurred. The response carries the standard Telnyx error envelope.
- `4XX` — An error occurred. The response carries the standard Telnyx error envelope.

---

[API](https://skmtc.net/team-telnyx/apis/telnyx-api-2.md) · [All operations](https://skmtc.net/team-telnyx/apis/telnyx-api-2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/team-telnyx/telnyx-api-2/versions/8f5f4e537994/schema)