Skip to main content
Idea

API/UI versioning inadequate for exports

Related products:Lucidchart
  • March 6, 2026
  • 3 replies
  • 28 views

Forum|alt.badge.img+1

Hi there,

I’m currently working on a process to automatically export diagrams from lucid, to store the artifacts for regulatory purposes. However, I’m not able to marry the versioning observed in the UI and API.

High level overview is quite straight forward:

  • User edits a document, (multiple diagrams in different pages)
  • User using the ui, names the version
  • User triggers tool to export the document
    • Tool hits /documents/{id} to obtain:
      • Number of pages
      • Version
    • Tool exports each individual page using same endpoint
      • (since only one page can be exported per API call)

My plan was to be able to confirm that the version of the document I’m fetching is the intended on (i.e. the named revision).

  1. However, named versions are not shown in the API. And numeric versions are not shown in the UI
    1. This means I can’t prove that the document I’m exporting is actually the indented one - there is no way to marry them.
      1. Imagining Alice and Bob:
        1. Alice updates the diagrams and named the latest document version 1.0 (as you can do in the revision history).
        2. Bob makes an accidental change, does not name the revision. 
        3. Alice initiates export which includes Bob’s accidental change as the API only regards the latest version. Since there is no way to observe the numeric version in the UI, nor is it possible to observe the named version in the API, Alice can’t confirm the export was what she wanted. 
  2. The page export via /documents/{id} doesn’t embed any versioning in the metadata
    1. Similar issue to the above, but on a more narrow time window, from the moment one obtains the version from /document/{id} endpoint, to running all API calls to export each page, a change could be made before each API call has run. There is no way to verify this.

Is there any way around this?

The only way I see is the following:

  • Expose named versions in API or provide a way to show numeric versions in the UI
  • Export of pages with image/png or any other format, should embed versions in the produced artifact.

With the current limitations, the API isn’t useful for us.

 

Thanks

Comments

alison cheney
Forum|alt.badge.img+4
  • Lucid community team
  • March 12, 2026

Hi ​@sata,

Thank you for your thoughtful post and idea in our Lucid Community! The "Alice and Bob" scenario you described perfectly illustrates the technical challenge of maintaining a single source of truth for regulatory exports.

Unfortunately, marrying named revisions from the UI with numeric versions in the API isn’t currently supported in Lucid, but we’re very interested in your feedback and committed to continually improving our products. If you’re willing to share, we’d love to hear more details about your use case or what you’d like to see in this experience within this thread. This thread is visible to others within the Product Feedback section of the community - from here, they can upvote it and add details of their own.

We encourage anyone else who’s interested in this to upvote this post and share any additional details about your use case or what you’d like to see in this experience. For more information about how we manage feedback in this community, please take a look at this post:

 

 


Forum|alt.badge.img+1
  • Author
  • March 13, 2026

Hi ​@sata,

Thank you for your thoughtful post and idea in our Lucid Community! The "Alice and Bob" scenario you described perfectly illustrates the technical challenge of maintaining a single source of truth for regulatory exports.

Unfortunately, marrying named revisions from the UI with numeric versions in the API isn’t currently supported in Lucid, but we’re very interested in your feedback and committed to continually improving our products. If you’re willing to share, we’d love to hear more details about your use case or what you’d like to see in this experience within this thread. This thread is visible to others within the Product Feedback section of the community - from here, they can upvote it and add details of their own.

We encourage anyone else who’s interested in this to upvote this post and share any additional details about your use case or what you’d like to see in this experience. For more information about how we manage feedback in this community, please take a look at this post:

 

 



Hi ​@alison cheney 

The use case is as mentioned for regulatory purpose in UK jurisdiction for finance industry. We need to demonstrate how our diagrams are approved by a CAB group, stored via version control in a immutable way and when exported (i.e. embedded in documentation), being able to reference back to which exact version the diagram consist of. I don’t believe this storage needs to sit with lucid but lucid should aim to make it easier for people to follow regulatory needs. Currently, one  way to reconcile this in automated way is to do perceptual hash matching of the images via Magick library to ensure what we have in our version controlled system matches the latest version in lucid before introducing a new change on top of it. 

If Lucid offered immutable named versions (i.e. they can’t be reused once created), and such named versions were visible through API, this reconciliation would be much easier. If any discrepancy is found, i.e. an unwanted changed was introduced in Lucid, the ability to revert the document to the last immutable named version would be easily done to ensure a clean state.

I can see FedRAMP have similar requirements via NIST SP 800-53:

  • CM-3 (Configuration Change Control) — requires documenting change decisions, reviewing proposed changes for security/privacy impact, implementing changes through a Change Advisory Board, and retaining records of configuration-controlled changes for a defined period.
  • CM-3(1) — mandates automated documentation of all proposed and implemented changes with notifications to approval authorities.
  • CM-5(1) — requires automated audit records of enforcement actions to support after-the-fact verification of authorization and detection of unauthorized changes.


I can see Lucid is now authorized for FedRAMP, perhaps this is worth looking into, how regulatory needs are met for public sector in the US as well.


alison cheney
Forum|alt.badge.img+4
  • Lucid community team
  • March 16, 2026

Hi ​@sata,

Thank you so much for providing this additional detail. This level of context regarding regulatory requirements, specific compliance frameworks like NIST, and your current technical workaround is incredibly helpful for our product team as they review and prioritize these requests.

We encourage anyone else who is interested in this functionality to upvote this post and share more about your own use cases or what you’d like to see in this experience!