Lucid Chart
101 min
\#lucid chart the lucid chart connector streamlines diagramming and collaboration workflows by integrating with lucid chart's api, enabling automated actions within the swimlane turbine platform lucid chart is a visual workspace that combines diagramming, data visualization, and collaboration to accelerate understanding and drive innovation the lucid chart connector for swimlane turbine enables users to automate the creation, copying, and management of diagrams and folders, enhancing team collaboration and operational efficiency with this integration, users can seamlessly import, export, and search for lucid chart documents, as well as manage user profiles and audit logs, all within the swimlane turbine platform this connector empowers security teams to maintain organized, accessible, and secure visual resources, streamlining processes and safeguarding information limitations none to date additional docs for more information, refer to the lucid chart api documentation https //lucid readme io/reference/overview prerequisites to effectively utilize the lucid chart connector with swimlane turbine, you must have oauth2 refresh token authentication with the following parameters url the endpoint url for lucid chart api access client id the client identifier as registered in lucid chart application settings client secret the secret key associated with your lucid chart client id refresh token a token used to obtain a new access token when the current access token expires http bearer token authentication with the following parameters url the endpoint url for lucid chart api access token a bearer token such as jwt to authenticate api requests capabilities this connector provides the following capabilities copy document create document create folder document contents folders get audit logs documents get folder get profile get user get/export document import document list folder contents list root folder contents users list users restore folder search documents and so on copy document copies one of the requesting user's existing documents, with the specified title lucid chart documentation for this action can be found \[here] ( https //lucid readme io/reference/createorcopyorimportdocument https //lucid readme io/reference/createorcopyorimportdocument ) create document creates a new document for the requesting user, with the specified title lucid chart documentation for this action can be found \[here] ( https //lucid readme io/reference/createorcopyorimportdocument https //lucid readme io/reference/createorcopyorimportdocument ) create folder create a new folder lucid chart documentation for this action can be found \[here] ( https //lucid readme io/reference/createfolder https //lucid readme io/reference/createfolder ) document contents folders retrieves information about the contents of the requested lucidchart or lucidspark document lucid chart documentation for this action can be found \[here] ( https //lucid readme io/reference/getdocumentcontent https //lucid readme io/reference/getdocumentcontent ) get audit logs documents lucid chart documentation for this action can be found \[here] ( https //lucid readme io/reference/getauditlogs https //lucid readme io/reference/getauditlogs ) get folder retrieves information about the requested folder lucid chart documentation for this action can be found \[here] ( https //lucid readme io/reference/getfolder https //lucid readme io/reference/getfolder ) get profile retrieves basic information about the authenticated user lucid chart documentation for this action can be found \[here] ( https //lucid readme io/reference/getuserprofile https //lucid readme io/reference/getuserprofile ) get/export document retrieves information about the requested document lucid chart documentation for this action can be found \[here] ( https //lucid readme io/reference/getorexportdocument https //lucid readme io/reference/getorexportdocument ) get user retrieves information about the requested user lucid chart documentation for this action can be found \[here] ( https //lucid readme io/reference/getuser https //lucid readme io/reference/getuser ) import document imports an external non lucid file as a new document within lucid lucid chart documentation for this action can be found \[here] ( https //lucid readme io/reference/createorcopyorimportdocument https //lucid readme io/reference/createorcopyorimportdocument ) list folder contents retrieves basic information about the contents of a given folder lucid chart documentation for this action can be found \[here] ( https //lucid readme io/reference/listfoldercontents https //lucid readme io/reference/listfoldercontents ) list root folder contents users retrieves basic information about the contents of the root folder lucid chart documentation for this action can be found \[here] ( https //lucid readme io/reference/listrootfoldercontents https //lucid readme io/reference/listrootfoldercontents ) list users retrieves information about all users on the authenticated account lucid chart documentation for this action can be found \[here] ( https //lucid readme io/reference/listusers https //lucid readme io/reference/listusers ) restore folder move the given folder and all of its contents to their original pre trash locations lucid chart documentation for this action can be found \[here] ( https //lucid readme io/reference/restorefolder https //lucid readme io/reference/restorefolder ) search documents retrieves information about documents that the authenticated user has at least read only access to lucid chart documentation for this action can be found \[here] ( https //lucid readme io/reference/searchdocuments https //lucid readme io/reference/searchdocuments ) search folders retrieves information about folders the authenticated user has at least read only access to lucid chart documentation for this action can be found \[here] ( https //lucid readme io/reference/searchfolders https //lucid readme io/reference/searchfolders ) search users by email retrieves information about all users on the authenticated user's account whose email is provided lucid chart documentation for this action can be found \[here] ( https //lucid readme io/reference/useremailsearch https //lucid readme io/reference/useremailsearch ) trash document moves the specified document to the trash for the requesting user lucid chart documentation for this action can be found \[here] ( https //lucid readme io/reference/trashdocument https //lucid readme io/reference/trashdocument ) trash folder move the given folder and all of its contents into the trash lucid chart documentation for this action can be found \[here] ( https //lucid readme io/reference/trashfolder https //lucid readme io/reference/trashfolder ) update folder allows the requester to modify certain fields on a folder lucid chart documentation for this action can be found \[here] ( https //lucid readme io/reference/updatefolder https //lucid readme io/reference/updatefolder ) configurations http bearer authentication authenticates using bearer token such as a jwt, etc configuration parameters parameter description type required url a url to the target host string required token the api key, token, etc string required verify ssl verify ssl certificate boolean optional http proxy a proxy to route requests through string optional refresh token for lucid chart api authentication authenticates using refresh token configuration parameters parameter description type required url a url to the target host string required cl id the client id string required cl secret the client secret string required refresh token refresh token string required verify ssl verify ssl certificate boolean optional http proxy a proxy to route requests through string optional actions copy document creates a copy of an existing lucid chart document with a specified title and template, requiring headers and json body endpoint url /documents method post input argument name type required description headers object required http headers for the request lucid api version string required the api version used in the request title string required the title of the copied document template string required the id of the document to be copied parent number optional the id of the folder to contain the copied document output parameter type description status code number http status code of the response reason string response reason phrase documentid string unique identifier title string output field title editurl string url endpoint for the request viewurl string url endpoint for the request version number output field version pagecount number count value canedit boolean output field canedit created string output field created creatorid number unique identifier lastmodified string output field lastmodified lastmodifieduserid number unique identifier customattributes array output field customattributes file name string name of the resource file string output field file customtags array output field customtags product string output field product status string status value classification string output field classification trashed object output field trashed parent object output field parent owner object output field owner id number unique identifier type string type of the resource example \[ { "status code" 200, "reason" "ok", "json body" { "documentid" "110808fd 4553 4316 bccf 4f25ff59a532", "title" "document title", "editurl" "https //lucid app/lucidchart/110808fd 4553 4316 bccf 4f25ff59a532/edit", "viewurl" "https //lucid app/lucidchart/110808fd 4553 4316 bccf 4f25ff59a532/view", "version" 101, "pagecount" 5, "canedit" false, "created" "2019 04 22t13 47 23z", "creatorid" 12345, "lastmodified" "2020 06 26t16 29 37z", "lastmodifieduserid" 54321, "customattributes" \[], "customtags" \[], "product" "lucidchart", "status" "complete" } } ] create document generates a new lucid chart document with a specified title and product type, requiring headers and a json body endpoint url /documents method post input argument name type required description headers object required http headers for the request lucid api version string required the api version used in the request title string required the title of the new document product string required the product type for the new document parent number optional the id of the folder to contain the new document output parameter type description status code number http status code of the response reason string response reason phrase documentid string unique identifier title string output field title editurl string url endpoint for the request viewurl string url endpoint for the request version number output field version pagecount number count value canedit boolean output field canedit created string output field created creatorid number unique identifier lastmodified string output field lastmodified lastmodifieduserid number unique identifier customattributes array output field customattributes file name string name of the resource file string output field file customtags array output field customtags product string output field product status string status value classification string output field classification trashed object output field trashed parent object output field parent owner object output field owner id number unique identifier type string type of the resource example \[ { "status code" 200, "reason" "ok", "json body" { "documentid" "110808fd 4553 4316 bccf 4f25ff59a532", "title" "document title", "editurl" "https //lucid app/lucidchart/110808fd 4553 4316 bccf 4f25ff59a532/edit", "viewurl" "https //lucid app/lucidchart/110808fd 4553 4316 bccf 4f25ff59a532/view", "version" 101, "pagecount" 5, "canedit" false, "created" "2019 04 22t13 47 23z", "creatorid" 12345, "lastmodified" "2020 06 26t16 29 37z", "lastmodifieduserid" 54321, "customattributes" \[], "customtags" \[], "product" "lucidchart", "status" "complete" } } ] create folder creates a new folder in lucid chart with specified 'name' and 'type', requiring headers and json body inputs endpoint url /folders method post input argument name type required description headers object required http headers for the request lucid api version number required the api version used in the request name string required name of the folder being created type string required type of folder being created parent number optional destination folder to create the new folder in output parameter type description status code number http status code of the response reason string response reason phrase id number unique identifier type string type of the resource name string name of the resource parent number output field parent created string output field created trashed string output field trashed attributes array output field attributes name string name of the resource value string value for the parameter example \[ { "status code" 200, "reason" "ok", "json body" { "id" 123456789, "type" "folder", "name" "folder name", "parent" 123456788, "created" "2020 06 26t16 29 37z", "trashed" "2022 01 20t12 14 18z", "attributes" \[] } } ] document contents retrieves details of a lucid chart or lucidspark document using the document's unique id provided in path parameters endpoint url /documents/{{id}}/contents method get input argument name type required description id string required id of the document to have contents retrieved headers object required http headers for the request lucid api version number required the api version used in the request output parameter type description status code number http status code of the response reason string response reason phrase id string unique identifier title string output field title product string output field product pages array output field pages file name string name of the resource file string output field file data object response data collections array output field collections file name string name of the resource file string output field file example \[ { "status code" 200, "reason" "ok", "json body" { "id" "8e7b19ec 27ff 40e3 beb8 03f51b1661b2", "title" "document title", "product" "lucidchart", "pages" \[], "data" {} } } ] get audit logs retrieves audit logs for the account, requiring specific headers and parameters to be set endpoint url /auditlogs method get input argument name type required description from string optional the timestamp from which the audit logs will be returned defaults to 14 days prior to the "to" parameter if it is defined, otherwise 14 days prior to the current timestamp to string optional the timestamp to which the logs will be returned defaults to the current timestamp pagesize number optional the number of audit logs to return per request defaults to 200 pagetoken string optional a token used for pagination to retrieve the next page of results when polling audit logs headers object required http headers for the request lucid api version string required the api version used in the request output parameter type description status code number http status code of the response reason string response reason phrase example \[ { "status code" 200, "reason" "ok", "json body" \[ {} ] } ] get folder retrieves details for a specified folder in lucid chart using the folder's unique id provided in path parameters endpoint url /folders/{{id}} method get input argument name type required description id number required id of the folder to be retrieved headers object required http headers for the request lucid api version number required the api version used in the request output parameter type description status code number http status code of the response reason string response reason phrase id number unique identifier type string type of the resource name string name of the resource parent number output field parent created string output field created trashed string output field trashed attributes array output field attributes name string name of the resource value string value for the parameter example \[ { "status code" 200, "reason" "ok", "json body" { "id" 123456789, "type" "folder", "name" "folder name", "parent" 123456788, "created" "2020 06 26t16 29 37z", "trashed" "2022 01 20t12 14 18z", "attributes" \[] } } ] get or export document retrieves information or exports the specified lucid chart document using its unique id provided in path parameters endpoint url /documents/{{id}} method get input argument name type required description crop string optional specifies the crop settings for the document export optional for export operation page number optional 1 based page index of the document to export defaults to the first page only a single page is allowed pageid string optional specific page of the document to export only a single page is allowed id string required the id of the document to retrieve headers object required http headers for the request lucid api version number required the api version used in the request output parameter type description status code number http status code of the response reason string response reason phrase documentid string unique identifier title string output field title editurl string url endpoint for the request viewurl string url endpoint for the request version number output field version pagecount number count value canedit boolean output field canedit created string output field created creatorid number unique identifier lastmodified string output field lastmodified lastmodifieduserid number unique identifier customattributes array output field customattributes file name string name of the resource file string output field file customtags array output field customtags product string output field product status string status value classification string output field classification trashed object output field trashed parent object output field parent owner object output field owner id number unique identifier type string type of the resource example \[ { "status code" 200, "reason" "ok", "json body" { "documentid" "110808fd 4553 4316 bccf 4f25ff59a532", "title" "document title", "editurl" "https //lucid app/lucidchart/110808fd 4553 4316 bccf 4f25ff59a532/edit", "viewurl" "https //lucid app/lucidchart/110808fd 4553 4316 bccf 4f25ff59a532/view", "version" 101, "pagecount" 5, "canedit" false, "created" "2019 04 22t13 47 23z", "creatorid" 12345, "lastmodified" "2020 06 26t16 29 37z", "lastmodifieduserid" 54321, "customattributes" \[], "customtags" \[], "product" "lucidchart", "status" "complete" } } ] get profile retrieves basic information about the authenticated lucid chart user, including headers endpoint url /users/me/profile method get input argument name type required description headers object required http headers for the request lucid api version string required the api version used in the request output parameter type description status code number http status code of the response reason string response reason phrase accountid number unique identifier username string name of the resource email string output field email fullname string name of the resource id number unique identifier example \[ { "status code" 200, "reason" "ok", "json body" { "accountid" 100, "username" "johndoe", "email" "john doe\@example com", "fullname" "john doe", "id" 101 } } ] get user retrieves detailed information about a specific user in lucid chart using the user's unique identifier endpoint url /users/{{id}} method get input argument name type required description id number required id of the user to be retrieved headers object required http headers for the request lucid api version string required the api version used in the request output parameter type description status code number http status code of the response reason string response reason phrase accountid number unique identifier email string output field email name string name of the resource userid number unique identifier username string name of the resource roles array output field roles example \[ { "status code" 200, "reason" "ok", "json body" { "accountid" 100, "email" "john doe\@example com", "name" "john doe", "userid" 101, "username" "johndoe", "roles" \[] } } ] import document imports an external file into lucid chart as a new document, requiring headers, json body with type, product, and title, and files endpoint url /documents method post input argument name type required description headers object required http headers for the request lucid api version string required the api version used in the request type string required the type of file provided for import product string required the product type for importing a document title string required title that should be given to the newly imported document parent number optional id of the folder to create the new document in files object required privately upload and analyse a file file string optional parameter for import document file name string optional name of the resource output parameter type description status code number http status code of the response reason string response reason phrase documentid string unique identifier title string output field title editurl string url endpoint for the request viewurl string url endpoint for the request version number output field version pagecount number count value canedit boolean output field canedit created string output field created creatorid number unique identifier lastmodified string output field lastmodified lastmodifieduserid number unique identifier customattributes array output field customattributes file name string name of the resource file string output field file customtags array output field customtags product string output field product status string status value classification string output field classification trashed object output field trashed parent object output field parent owner object output field owner id number unique identifier type string type of the resource example \[ { "status code" 200, "reason" "ok", "json body" { "documentid" "110808fd 4553 4316 bccf 4f25ff59a532", "title" "document title", "editurl" "https //lucid app/lucidchart/110808fd 4553 4316 bccf 4f25ff59a532/edit", "viewurl" "https //lucid app/lucidchart/110808fd 4553 4316 bccf 4f25ff59a532/view", "version" 101, "pagecount" 5, "canedit" false, "created" "2019 04 22t13 47 23z", "creatorid" 12345, "lastmodified" "2020 06 26t16 29 37z", "lastmodifieduserid" 54321, "customattributes" \[], "customtags" \[], "product" "lucidchart", "status" "complete" } } ] list folder contents retrieves basic information about the contents within a specified lucid chart folder, identified by its unique id endpoint url /folders/{{id}}/contents method get input argument name type required description id string required id of the folder or root to retrieve contents of the authenticated user's root directory headers object required http headers for the request lucid api version string required the api version used in the request output parameter type description status code number http status code of the response reason string response reason phrase example \[ { "status code" 200, "reason" "ok", "json body" \[ {} ] } ] list root folder contents retrieves basic information about the contents of the lucid chart root folder, requiring specific headers endpoint url /folders/root/contents method get input argument name type required description headers object required http headers for the request lucid api version string required the api version used in the request output parameter type description status code number http status code of the response reason string response reason phrase example \[ { "status code" 200, "response headers" {}, "reason" "ok", "json body" \[ {} ] } ] list users retrieves information about all users associated with the authenticated lucid chart account, requiring specific headers endpoint url /users method get input argument name type required description headers object required http headers for the request lucid api version string required the api version used in the request output parameter type description status code number http status code of the response reason string response reason phrase example \[ { "status code" 200, "reason" "ok", "json body" \[ {} ] } ] restore folder moves a specified folder, along with all contents, back to its original location from the trash in lucid chart; requires folder 'id' endpoint url /folders/{{id}}/restore method post input argument name type required description id number required id of the folder to be restored from the trash headers object required http headers for the request lucid api version number required the api version used in the request output parameter type description status code number http status code of the response reason string response reason phrase example \[ { "status code" 200, "reason" "ok", "json body" {} } ] search documents retrieves details of lucid chart documents accessible by the user, requiring specific headers and a json body endpoint url /documents/search method post input argument name type required description headers object required http headers for the request lucid api version number required the api version used in the request product array optional array of lucid suite products to filter by createdstarttime string optional date and time to filter documents that have been created after createdendtime string optional date and time to filter documents that have been created before lastmodifiedafter string optional date and time to filter documents that have been modified after keywords string optional keywords to search against document content and titles output parameter type description status code number http status code of the response reason string response reason phrase documentid string unique identifier title string output field title editurl string url endpoint for the request viewurl string url endpoint for the request version number output field version pagecount number count value canedit boolean output field canedit created string output field created creatorid number unique identifier lastmodified string output field lastmodified lastmodifieduserid number unique identifier customattributes array output field customattributes file name string name of the resource file string output field file customtags array output field customtags product string output field product status string status value classification string output field classification trashed object output field trashed parent object output field parent owner object output field owner id number unique identifier type string type of the resource example \[ { "status code" 200, "reason" "ok", "json body" { "documentid" "110808fd 4553 4316 bccf 4f25ff59a532", "title" "document title", "editurl" "https //lucid app/lucidchart/110808fd 4553 4316 bccf 4f25ff59a532/edit", "viewurl" "https //lucid app/lucidchart/110808fd 4553 4316 bccf 4f25ff59a532/view", "version" 101, "pagecount" 5, "canedit" false, "created" "2019 04 22t13 47 23z", "creatorid" 12345, "lastmodified" "2020 06 26t16 29 37z", "lastmodifieduserid" 54321, "customattributes" \[], "customtags" \[], "product" "lucidchart", "status" "complete" } } ] search folders retrieves folder details accessible by the user in lucid chart, requiring 'type' as a json body input endpoint url /folders/search method post input argument name type required description headers object required http headers for the request lucid api version number required the api version used in the request lucid request as string required the user role to make the request as this header is only available to service accounts type string required the type of item to search for userids array optional list of userids to include in search ownedbyusers boolean optional truthy if search results should only include documents owned by users specified by userids keywords string optional keywords to search against folder content and titles output parameter type description status code number http status code of the response reason string response reason phrase example \[ { "status code" 200, "reason" "ok", "json body" \[ {} ] } ] search users by email retrieves details for users associated with the provided email addresses in lucid chart endpoint url /users/searchbyemail method post input argument name type required description headers object optional http headers for the request lucid api version string optional the api version used in the request emails array required array of email addresses to search for output parameter type description status code number http status code of the response reason string response reason phrase example \[ { "status code" 200, "reason" "ok", "json body" \[ {} ] } ] trash document moves a specified lucid chart document to the trash using the document's unique id provided in path parameters endpoint url /documents/{{id}}/trash method post input argument name type required description id string required id of the document to be moved to the trash headers object required http headers for the request lucid api version number required the api version used in the request output parameter type description status code number http status code of the response reason string response reason phrase example \[ { "status code" 200, "reason" "ok", "json body" {} } ] trash folder moves a specified folder, along with all its contents, to the trash in lucid chart using the folder's unique id endpoint url /folders/{{id}}/trash method post input argument name type required description id number required id of the folder to be moved to the trash headers object required http headers for the request lucid api version number required the api version used in the request output parameter type description status code number http status code of the response reason string response reason phrase example \[ { "status code" 200, "reason" "ok", "json body" {} } ] update folder modifies specified fields of a lucid chart folder using the folder's id and provided name in the request body endpoint url /folders/{{id}} method patch input argument name type required description id number required id of the folder to be updated headers object required http headers for the request lucid api version number required the api version used in the request name string required new name for the folder being updated parent number optional new parent for the folder being updated output parameter type description status code number http status code of the response reason string response reason phrase id number unique identifier type string type of the resource name string name of the resource parent number output field parent created string output field created trashed string output field trashed attributes array output field attributes name string name of the resource value string value for the parameter example \[ { "status code" 200, "reason" "ok", "json body" { "id" 123456789, "type" "folder", "name" "folder name", "parent" 123456788, "created" "2020 06 26t16 29 37z", "trashed" "2022 01 20t12 14 18z", "attributes" \[] } } ]