Skip to main content
Solved

Lucidspark Rest API

  • August 20, 2024
  • 16 replies
  • 432 views

Michel L
Forum|alt.badge.img+11

Did API exist on LucidSpark for developers ?

Best answer by jkrueger

Hi @Michel L , 

You are correct. At this time, the GET Document Contents endpoint does not support Lucidspark boards.

You can get around this by exporting a Lucidspark board to Lucidchart.

There are two ways to export from Lucidspark to Lucidchart:

  1. ‘Export to Lucidchart’ in the document list menu

     

  2. Use the POST Copy Document endpoint with “product” : “lucidchart” and “template” : “<your Lucidspark document id>”. 

After a board is exported to Lucidchart, you could use GET Document Contents with the new Lucidchart document.

Hope this helps!

Comments

Humas1985
Lucid Legend Level 10
Forum|alt.badge.img+24
  • Lucid Legend Level 10
  • August 20, 2024

Hi @Michel L 

Yes - LucidSpark provides APIs for developers, enabling them to integrate and interact with the platform.

Specifically, LucidSpark offers two APIs: the REST API and the Extension API, which can be utilized in a similar manner to Lucidchart, allowing for seamless integration and customization.

To learn more please navigate to this help article - Guides (lucid.co)

Hope this helps - Happy to help further!!
Thank you very much and have a great one!
Warm regards


Michel L
Forum|alt.badge.img+11
  • Author
  • August 20, 2024

Hi @Humas1985 

Thank you for your reply,

So we just need to use lucidspark instead of lucidchart in the product field of the request isn’it?

Regards.


Humas1985
Lucid Legend Level 10
Forum|alt.badge.img+24
  • Lucid Legend Level 10
  • August 20, 2024

Hi @Michel L  - Yes, that's right.


Michel L
Forum|alt.badge.img+11
  • Author
  • September 24, 2024

Hi @Humas1985 

In fact i’m sorry to tell you that you’re wrong.

If you want to get the json content of a lucidspark file using this endpoint:

https://api.lucid.co/documents/{id}/contents

There is an error. 

It seems that the scope for this endpoint does not support lucidspark.

Any suggestions.

Regards.


jkrueger
Forum|alt.badge.img+2
  • Lucid product team
  • Answer
  • September 24, 2024

Hi @Michel L , 

You are correct. At this time, the GET Document Contents endpoint does not support Lucidspark boards.

You can get around this by exporting a Lucidspark board to Lucidchart.

There are two ways to export from Lucidspark to Lucidchart:

  1. ‘Export to Lucidchart’ in the document list menu

     

  2. Use the POST Copy Document endpoint with “product” : “lucidchart” and “template” : “<your Lucidspark document id>”. 

After a board is exported to Lucidchart, you could use GET Document Contents with the new Lucidchart document.

Hope this helps!


Forum|alt.badge.img

Any update on this?  I need to be able to programmatically modify embedded Lucidspark boards. But extensions won’t let me interact with them unless I’ve initiated an action in the extension on the lucid website (not my embedding application). So...I tried switching to APIs instead of extensions, and late in the game just now realized the topic of this thread: no LucidSpark support.  Is there a beta or similar program ?  Please advise how I can get programmatic CRUD on an embedded lucidspark board.


Michel L
Forum|alt.badge.img+11
  • Author
  • October 28, 2025

Hi ​@lorienpratt the endpoint 

https://api.lucid.co/documents/{0}/contents

Works now for LucidSpark.


...
"id": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
"title": "MyLucidSpark file",
"product": "lucidspark",
"pages": [
{
"id": "0_0",
"title": "Page 1",
...

Regards.


Forum|alt.badge.img

@Michel L great!  Is it documented anywhere?


Forum|alt.badge.img

Also, as far as I can tell, this doesn’t support any lucidspark CRUD, e.g. add a card, right?


Michel L
Forum|alt.badge.img+11
  • Author
  • October 29, 2025

@lorienpratt 
https://developer.lucid.co/reference/getdocumentcontent

but you cannot modify the content of the document if it is what you want.

Yo can IFAIK do that only with developing an extension.

So you could : 

  Create an extension

  Open the document using Rest API

  Fire the extension.

Regards.


 


Michael B
Forum|alt.badge.img+4
  • Lucid product team
  • October 29, 2025

To confirm Michel’s response, there is not currently a way to modify the contents of a document via the Rest API. The extension API can be used for document modification, but that still expects a user interaction on the canvas.

 

We recognize the demand for programmatic modification of a document, but do not support that at this time.


Forum|alt.badge.img

Thanks ​@Michael B  and ​@Michel L very much appreciated.  If we return to my primary query, it was about whether there’s some way to not have to open the board in the same session as my app in order to get the extension started up.  Right now, to run any app, I have to do this, which is cumbersome. I want my users to be able to just stay in my website, not to have to click a menu item (to start the extension operating) on a board on lucidspark.com as they currently have to do.


Forum|alt.badge.img

@lorienpratt 
https://developer.lucid.co/reference/getdocumentcontent

but you cannot modify the content of the document if it is what you want.

Yo can IFAIK do that only with developing an extension.

So you could : 

  Create an extension

  Open the document using Rest API

  Fire the extension.

Regards.


 

yes, but my understanding is that i can’t fire an extension programmatically, can I? Even if I’ve opened the doc via REST?


Michel L
Forum|alt.badge.img+11
  • Author
  • November 10, 2025

@lorienpratt 😊


Michael B
Forum|alt.badge.img+4
  • Lucid product team
  • November 10, 2025

Unfortunately, extensions can not run while the app is in a iframe and there are not currently plans to try and find a solution.


Zuzia S
Forum|alt.badge.img+8
  • Lucid community team
  • November 19, 2025

Hi, just jumping in here to let you ​@Michel L know that I have removed your email from this thread to protect your privacy. If you'd like, you can send a private message to ​@lorienpratt directly on this platform. 

Cheers!