v1

latestOpenAPI 3.0.3Lucid2026-07-14155181312.3 KB
Document Comments

List Document Threads

Retrieves all comment threads for the specified document. Each thread includes its ID, creation timestamp, and status (open or closed).

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

Path parameters

documentIdstring uuid required

ID of the document to retrieve comment threads for.

Response

OK with an array of Document Thread resources for the document's comment threads.

threadIdstring required

The unique ID of the comment thread.

createdstring date-time required

The date and time when the thread was created.

status'OPEN' | 'CLOSED' required

The status of a comment thread. OPEN indicates an unresolved thread, CLOSED indicates a resolved thread.

Example response

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