Lucid Document Comments API
Retrieve comment threads on a document, list comments within a thread, and post new comments to an existing thread.
Work with this as data
Every API here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for apis
7 MCP tools reach this
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.
Call it yourself
curl for this page
This API
curl "https://apis.io/api/v1/apis/lucid-document-comments-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"Discovery needs no key. Ratings and market analysis are Pro.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
OpenAPI Specification
openapi: 3.2.0
info:
title: Lucid REST Document Comments API
version: '1.0'
description: The Lucid REST API provides programmatic access to manage documents, users, folders, sharing, licensing, and audit logs across the Lucid Suite (Lucidchart, Lucidspark, and Lucidscale). Authenticate via OAuth 2.0 or API key.
contact:
name: Lucid Developer Platform
url: https://developer.lucid.co/
x-documentation: https://developer.lucid.co/reference/api
servers:
- url: https://api.lucid.co
tags:
- name: Document Comments
description: Retrieve comment threads on a document, list comments within a thread, and post new comments to an existing thread.
paths:
/v1/documents/{documentId}/threads:
get:
summary: List Document Threads
description: '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`
'
operationId: listDocumentThreads
tags:
- Document Comments
security:
- ApiKey:
- DocumentReadonly
- OAuth2:
- lucidchart.document.content:readonly
- lucidscale.document.content:readonly
- lucidspark.document.content:readonly
- lucid.document.content:readonly
parameters:
- name: documentId
in: path
required: true
schema:
type: string
format: uuid
description: ID of the document to retrieve comment threads for.
example: 110808fd-4553-4316-bccf-4f25ff59a532
responses:
'200':
description: OK with an array of Document Thread resources for the document's comment threads.
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/DocumentThread'
'400':
description: Bad Request if the document ID is malformed.
'403':
description: Forbidden if the app making the request does not have permission to the document, or if the document does not exist.
/v1/documents/{documentId}/threads/{threadId}/comments:
get:
summary: List Thread Comments
description: '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`
'
operationId: listDocumentThreadComments
tags:
- Document Comments
security:
- ApiKey:
- DocumentReadonly
- OAuth2:
- lucidchart.document.content:readonly
- lucidscale.document.content:readonly
- lucidspark.document.content:readonly
- lucid.document.content:readonly
parameters:
- name: documentId
in: path
required: true
schema:
type: string
format: uuid
description: ID of the document containing the thread.
example: 110808fd-4553-4316-bccf-4f25ff59a532
- name: threadId
in: path
required: true
schema:
type: string
description: ID of the comment thread to retrieve comments for.
example: abc123
responses:
'200':
description: OK with an array of Document Comment resources for the thread's comments.
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/DocumentComment'
'400':
description: Bad Request if the document ID is malformed.
'403':
description: Forbidden if the app making the request does not have permission to the document, or if the document does not exist.
'404':
description: Not Found if the specified thread does not exist on the document.
post:
summary: Post Thread Comment
description: 'Posts a new comment to an existing thread on a document. The comment text must be non-empty and cannot exceed 10,000 characters.
## Valid Authentication Methods
**API Key Grants:**
- `DocumentEdit`
**OAuth 2.0 User Token Scopes:**
- `lucidchart.document.content`
- `lucidscale.document.content`
- `lucidspark.document.content`
- `lucid.document.content`
'
operationId: postDocumentThreadComment
tags:
- Document Comments
security:
- ApiKey:
- DocumentEdit
- OAuth2:
- lucidchart.document.content
- lucidscale.document.content
- lucidspark.document.content
- lucid.document.content
parameters:
- name: documentId
in: path
required: true
schema:
type: string
format: uuid
description: ID of the document containing the thread.
example: 110808fd-4553-4316-bccf-4f25ff59a532
- name: threadId
in: path
required: true
schema:
type: string
description: ID of the comment thread to post a comment to.
example: abc123
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/PostCommentRequestBody'
responses:
'204':
description: No Content when the comment is successfully posted.
'400':
description: 'Bad Request.
* Comment must be non-empty.
* Comment must not exceed 10,000 characters.
* Comment cannot be posted to a closed thread.
'
'403':
description: Forbidden if the app making the request does not have write permission to the document, or if the document does not exist.
'404':
description: Not Found if the specified thread does not exist on the document.
components:
schemas:
PostCommentRequestBody:
type: object
description: Request body for posting a comment to a thread.
properties:
comment:
type: string
description: The text content of the comment. Must be non-empty and at most 10,000 characters.
example: This is a comment
required:
- comment
DocumentComment:
type: object
description: A comment within a comment thread on a document.
properties:
threadId:
type: string
description: The ID of the thread this comment belongs to.
example: abc123
userId:
type: integer
description: The ID of the user who posted the comment.
comment:
type: string
description: The text content of the comment.
example: This is a comment
created:
type: string
format: date-time
description: The date and time when the comment was created.
example: '2024-01-01T00:00:00Z'
assignees:
type:
- array
- 'null'
items:
type: integer
description: List of user IDs assigned to this comment, or null if no users are assigned.
required:
- threadId
- userId
- comment
- created
DocumentThread:
type: object
description: A comment thread on a document.
properties:
threadId:
type: string
description: The unique ID of the comment thread.
example: abc123
created:
type: string
format: date-time
description: The date and time when the thread was created.
example: '2024-01-01T00:00:00Z'
status:
$ref: '#/components/schemas/ThreadStatus'
required:
- threadId
- created
- status
ThreadStatus:
type: string
enum:
- OPEN
- CLOSED
description: The status of a comment thread. OPEN indicates an unresolved thread, CLOSED indicates a resolved thread.
securitySchemes:
OAuth2:
type: oauth2
flows:
authorizationCode:
authorizationUrl: https://lucid.app/oauth2/authorize
tokenUrl: https://api.lucid.co/oauth2/token
refreshUrl: https://api.lucid.co/oauth2/token
scopes:
account.audit.logs: View audit logs on your account.
account.info: View basic information about your account (e.g., account ID and account name) .
account.user: Create, view, edit, and delete users on your account.
account.user:readonly: View users on your account.
account.users:admin.readonly: View all users and their roles on your account.
account.user.transfercontent: Transfer ownership of a user's resources to another user on your account.
account.settings:readonly: View settings on your account.
account.legalhold: Create, view, and expire legal holds on your account.
account.legalhold:readonly: View legal holds on your account.
account.legalhold.users: Manage legal hold users on your account.
account.legalhold.users:readonly: View legal hold users on your account.
folder: Create, view, edit, share, and delete your folders. Organize your folders and their contents.
folder:readonly: View any of your folders and list their contents.
folder:admin: Perform admin actions on folders belonging to the account.
folder:admin.readonly: View all folders belonging to the account with admin permissions.
invitation: Accept document and folder share links.
invitation.accept: Accept document and folder share links.
cloud.credential: Manage cloud credentials.
cloud.credential:readonly: View cloud credentials.
cloud.datasource: Manage cloud data sources.
cloud.datasource:readonly: View cloud data sources.
cloud.model: Manage cloud models.
repository: Manage repositories.
repository:readonly: View repositories.
repository:admin: Perform admin actions on repositories.
lucid.document.content: Create, view, edit, and delete any Lucid document accessible by the user.
lucid.document.content:readonly: View and download any Lucid document accessible by the user.
lucid.document.content:admin: Perform admin actions on Lucid documents belonging to the account.
lucid.document.content:admin.readonly: View all Lucid documents belonging to the account with admin permissions.
lucid.document.content.share: Create, view, edit, and delete document collaborators, embeds, and share links for any Lucid document accessible by the user.
lucid.document.content.share:readonly: View document collaborators, embeds, and share links for any Lucid document accessible by the user.
lucid.document.content.share.collaborator: Create, view, edit, and delete document collaborators for any Lucid document accessible by the user.
lucid.document.content.share.collaborator:readonly: View document collaborators for any Lucid document accessible by the user.
lucid.document.content.share.embed: Create, view, edit, and delete document embeds for any Lucid document accessible by the user.
lucid.document.content.share.embed:readonly: View document embeds for any Lucid document accessible by the user.
lucid.document.content.share.link: Create, view, edit, and delete share links for any Lucid document accessible by the user.
lucid.document.content.share.link:readonly: View share links for any Lucid document accessible by the user.
lucid.document.storage:admin.readonly: Perform admin actions backing up Lucid documents belonging to the account.
lucid.document.app: View, edit, create, and manage folders and documents within an app.
lucid.document.app.folder: Create, view, edit, and manage any Lucid document within its app-specific folder.
lucid.document.app.picker: View, edit, and manage any Lucid document selected within an app.
lucid.document.app.picker:readonly: View and download any Lucid document selected within an app.
lucid.document.app.picker.share: Create, view, edit, and delete document collaborators, embeds, and share links for any Lucid document selected within an app.
lucid.document.app.picker.share:readonly: View document collaborators, embeds, and share links for any Lucid document selected within an app.
lucid.document.app.picker.share.collaborator: Create, view, edit, and delete document collaborators for any Lucid document selected within an app.
lucid.document.app.picker.share.collaborator:readonly: View document collaborators for any Lucid document selected within an app.
lucid.document.app.picker.share.embed: Create, view, edit, and delete document embeds for any Lucid document selected within an app.
lucid.document.app.picker.share.embed:readonly: View document embeds for any Lucid document selected within an app.
lucid.document.app.picker.share.link: Create, view, edit, and delete share links for any Lucid document selected within an app.
lucid.document.app.picker.share.link:readonly: View share links for any Lucid document selected within an app.
lucid.document.accessRequest: Request access to Lucid documents.
licenses:admin: Perform admin actions on licenses and subscriptions belonging to the account.
licenses:admin.readonly: View licenses and subscriptions belonging to the account with admin permissions.
teams: Create, view, and edit, archive, and restore any teams on your account. Control which users belong to teams.
teams:readonly: View any teams on your account and list which users belong to them.
teams:admin: Manage teams on your account.
lucidchart.document.app: View, edit, and manage any Lucidchart document selected for this third-party application. Create, view, edit, and manage any Lucidchart document within its app-specific folder.
lucidchart.document.app.folder: Create, view, edit, and manage any Lucidchart document within its app-specific folder.
lucidchart.document.app.picker: View, edit, and manage any Lucidchart document selected for this third-party application.
lucidchart.document.app.picker:readonly: View and download any Lucidchart document selected for this third-party application.
lucidchart.document.app.picker.share: Create, view, edit, and delete document collaborators, embeds, and share links for any Lucidchart document selected for this third-party application.
lucidchart.document.app.picker.share:readonly: View document collaborators, embeds, and share links for any Lucidchart document selected for this third-party application.
lucidchart.document.app.picker.share.collaborator: Create, view, edit, and delete collaborators and invitations of any Lucidchart document on your team or enterprise account selected for the third-party application.
lucidchart.document.app.picker.share.collaborator:readonly: View collaborators and invitations of any Lucidchart document on your team or enterprise account selected for the third-party application.
lucidchart.document.app.picker.share.embed: Create, view, edit, and delete embeds of any Lucidchart document on your team or enterprise account selected for the third-party application.
lucidchart.document.app.picker.share.embed:readonly: View embeds of any Lucidchart document on your team or enterprise account selected for the third-party application.
lucidchart.document.app.picker.share.link: Create, view, edit, and delete the third party application's share links of any Lucidchart document on your team or enterprise account selected for the third-party application.
lucidchart.document.app.picker.share.link:readonly: View the third party application's share links of any Lucidchart document on your team or enterprise account selected for the third-party application.
lucidchart.document.content: Create, view, edit, and delete any Lucidchart document on your account.
lucidchart.document.content:readonly: View and download any Lucidchart document on your account.
lucidchart.document.content:admin: Perform admin actions on Lucidchart documents belonging to the account.
lucidchart.document.content:admin.readonly: View all Lucidchart documents belonging to the account with admin permissions.
lucidchart.document.content.share: Create, view, edit, and delete document collaborators, embeds, and share links for any of your Lucidchart documents.
lucidchart.document.content.share:readonly: View document collaborators, embeds, and share links for any of your Lucidchart documents.
lucidchart.document.content.share.collaborator: Create, view, edit, and delete collaborators and invitations for any of your Lucidchart documents on your team or enterprise account.
lucidchart.document.content.share.collaborator:readonly: View collaborators and invitations for any of your Lucidchart documents on your team or enterprise account.
lucidchart.document.content.share.embed: Create, view, edit, and delete embeds for any of your Lucidchart documents on your team or enterprise account.
lucidchart.document.content.share.embed:readonly: View embeds for any of your Lucidchart documents on your team or enterprise account.
lucidchart.document.content.share.link: Create, view, edit, and delete the third party application's share links for any of your Lucidchart documents on your team or enterprise account.
lucidchart.document.content.share.link:readonly: View the third party application's share links for any of your Lucidchart documents on your team or enterprise account.
lucidchart.document.storage:admin.readonly: Perform admin actions backing up Lucidchart documents belonging to the account.
lucidchart.document.accessRequest: Request access to Lucidchart documents.
lucidspark.document.app: View, edit, and manage any Lucidspark board selected for this third-party application. Create, view, edit, and manage any Lucidspark board within its app-specific folder.
lucidspark.document.app.folder: Create, view, edit, and manage any Lucidspark board within its app-specific folder.
lucidspark.document.app.picker: View, edit, and manage any Lucidspark board selected for this third-party application.
lucidspark.document.app.picker:readonly: View and download any Lucidspark board selected for this third-party application.
lucidspark.document.app.picker.share: Create, view, edit, and delete document collaborators, embeds, and share links for any Lucidspark board selected for this third-party application.
lucidspark.document.app.picker.share:readonly: View document collaborators, embeds, and share links for any Lucidspark board selected for this third-party application.
lucidspark.document.app.picker.share.collaborator: Create, view, edit, and delete collaborators and invitations of any Lucidspark board on your team or enterprise account selected for the third-party application.
lucidspark.document.app.picker.share.collaborator:readonly: View collaborators and invitations of any Lucidspark board on your team or enterprise account selected for the third-party application.
lucidspark.document.app.picker.share.embed: Create, view, edit, and delete embeds of any Lucidspark board on your team or enterprise account selected for the third-party application.
lucidspark.document.app.picker.share.embed:readonly: View embeds of any Lucidspark board on your team or enterprise account selected for the third-party application.
lucidspark.document.app.picker.share.link: Create, view, edit, and delete the third party application's share links of any Lucidspark board on your team or enterprise account selected for the third-party application.
lucidspark.document.app.picker.share.link:readonly: View the third party application's share links of any Lucidspark board on your team or enterprise account selected for the third-party application.
lucidspark.document.content: Create, view, edit, and delete any Lucidspark board on your account.
lucidspark.document.content:readonly: View and download any Lucidspark board on your account.
lucidspark.document.content:admin: Perform admin actions on Lucidspark boards belonging to the account.
lucidspark.document.content:admin.readonly: View all Lucidspark boards belonging to the account with admin permissions.
lucidspark.document.content.share: Create, view, edit, and delete document collaborators, embeds, and share links for any of your Lucidspark boards.
lucidspark.document.content.share:readonly: View document collaborators, embeds, and share links for any of your Lucidspark boards.
lucidspark.document.content.share.collaborator: Create, view, edit, and delete collaborators and invitations for any of your Lucidspark boards on your team or enterprise account.
lucidspark.document.content.share.collaborator:readonly: View collaborators and invitations for any of your Lucidspark boards on your team or enterprise account.
lucidspark.document.content.share.embed: Create, view, edit, and delete embeds for any of your Lucidspark boards on your team or enterprise account.
lucidspark.document.content.share.embed:readonly: View embeds for any of your Lucidspark boards on your team or enterprise account.
lucidspark.document.content.share.link: Create, view, edit, and delete the third party application's share links for any of your Lucidspark boards on your team or enterprise account.
lucidspark.document.content.share.link:readonly: View the third party application's share links for any of your Lucidspark boards on your team or enterprise account.
lucidspark.document.storage:admin.readonly: Perform admin actions backing up Lucidspark boards belonging to the account.
lucidspark.document.accessRequest: Request access to Lucidspark boards.
lucidscale.document.app: View, edit, and manage any Lucidscale model selected for this third-party application. Create, view, edit, and manage any Lucidscale model within its app-specific folder.
lucidscale.document.app.folder: Create, view, edit, and manage any Lucidscale model within its app-specific folder.
lucidscale.document.app.picker: View, edit, and manage any Lucidscale model selected for this third-party application.
lucidscale.document.app.picker:readonly: View and download any Lucidscale model selected for this third-party application.
lucidscale.document.app.picker.share: Create, view, edit, and delete document collaborators, embeds, and share links for any Lucidscale model selected for this third-party application.
lucidscale.document.app.picker.share:readonly: View document collaborators, embeds, and share links for any Lucidscale model selected for this third-party application.
lucidscale.document.app.picker.share.collaborator: Create, view, edit, and delete collaborators and invitations of any Lucidscale model on your team or enterprise account selected for the third-party application.
lucidscale.document.app.picker.share.collaborator:readonly: View collaborators and invitations of any Lucidscale model on your team or enterprise account selected for the third-party application.
lucidscale.document.app.picker.share.embed: Create, view, edit, and delete embeds of any Lucidscale model on your team or enterprise account selected for the third-party application.
lucidscale.document.app.picker.share.embed:readonly: View embeds of any Lucidscale model on your team or enterprise account selected for the third-party application.
lucidscale.document.app.picker.share.link: Create, view, edit, and delete the third party application's share links of any Lucidscale model on your team or enterprise account selected for the third-party application.
lucidscale.document.app.picker.share.link:readonly: View the third party application's share links of any Lucidscale model on your team or enterprise account selected for the third-party application.
lucidscale.document.content: Create, view, edit, and delete any Lucidscale model on your account.
lucidscale.document.content:readonly: View and download any Lucidscale model on your account.
lucidscale.document.content:admin: Perform admin actions on Lucidscale models belonging to the account.
lucidscale.document.content:admin.readonly: View all Lucidscale models belonging to the account with admin permissions.
lucidscale.document.content.share: Create, view, edit, and delete document collaborators, embeds, and share links for any of your Lucidscale models.
lucidscale.document.content.share:readonly: View document collaborators, embeds, and share links for any of your Lucidscale models.
lucidscale.document.content.share.collaborator: Create, view, edit, and delete collaborators and invitations for any of your Lucidscale models on your team or enterprise account.
lucidscale.document.content.share.collaborator:readonly: View collaborators and invitations for any of your Lucidscale models on your team or enterprise account.
lucidscale.document.content.share.embed: Create, view, edit, and delete embeds for any of your Lucidscale models on your team or enterprise account.
lucidscale.document.content.share.embed:readonly: View embeds for any of your Lucidscale models on your team or enterprise account.
lucidscale.document.content.share.link: Create, view, edit, and delete the third party application's share links for any of your Lucidscale models on your team or enterprise account.
lucidscale.document.content.share.link:readonly: View the third party application's share links for any of your Lucidscale models on your team or enterprise account.
lucidscale.document.storage:admin.readonly: Perform admin actions backing up Lucidscale models belonging to the account.
lucidscale.document.accessRequest: Request access to Lucidscale models.
offline_access: Continue to perform authorized actions when you're not logged in (required to refresh tokens).
user.profile: Allow applications to view basic information about you (e.g., full name, username, and email).
document.app: View, edit, and manage any Lucidchart document selected for this third-party application. Create, view, edit, and manage any Lucidchart document within its app-specific folder.
document.app.folder: Create, view, edit, and manage any Lucidchart document within its app-specific folder.
document.app.picker: View, edit, and manage any Lucidchart document selected for this third-party application.
document.app.picker:readonly: View and download any Lucidchart document selected for this third-party application.
document.content: Create, view, edit, and delete any Lucidchart document on your account.
document.content:readonly: View and download any Lucidchart document on your account.
ApiKey:
type: http
scheme: bearer
x-harvest:
harvested: '2026-08-01'
method: searched
source: https://lucid-developer-docs.readme.io/mcp
note: 'Assembled operation-by-operation from Lucid''s own documentation MCP server (tools list-endpoints + get-endpoint), which returns verbatim OpenAPI 3.0.3 fragments out of the spec Lucid uploaded to its ReadMe hub (/branches/1.4/apis/lucid-rest-api.json). Paths, operations, parameters, request bodies, responses, components and securitySchemes are provider content, unmodified. Only the info block is ours: ReadMe''s per-endpoint fragments omit info, so title/description are copied verbatim from the provider''s own list-specs description for this spec.'