v1

latestOpenAPI 3.0.3Lucid2026-07-14155181312.3 KB
Document Comments

List Thread Comments

Retrieves all comments within a specific thread of a document. Each comment includes the author, comment text, creation timestamp, and any assigned users.

Valid Authentication Methods

API Key Grants:

  • DocumentReadonly

OAuth 2.0 User Token Scopes:

  • lucidchart.document.content:readonly
  • lucidscale.document.content:readonly
  • lucidspark.document.content:readonly
  • lucid.document.content:readonly
get/v1/documents/{documentId}/threads/{threadId}/comments

Path parameters

documentIdstring uuid required

ID of the document containing the thread.

threadIdstring required

ID of the comment thread to retrieve comments for.

Response

OK with an array of Document Comment resources for the thread's comments.

threadIdstring required

The ID of the thread this comment belongs to.

userIdinteger required

The ID of the user who posted the comment.

commentstring required

The text content of the comment.

createdstring date-time required

The date and time when the comment was created.

assigneesinteger[] nullable

List of user IDs assigned to this comment, or null if no users are assigned.

Example response

[
  {
    "threadId": "abc123",
    "comment": "This is a comment",
    "created": "2024-01-01T00:00:00Z"
  }
]