Change Document Embed Version

post

https://api.lucid.co/v1/documents/{documentId}/embeds/{embedId}/changeVersion

Updates the version type of an existing document embed. When called with an embedVersion of "snapshot-version", the endpoint associates the existing embed with a snapshot of the document's current state. Updating an embed's version to snapshot-version cannot be reversed.

Updates the version type of an existing document embed.

Calling this endpoint with an embedVersion of "snapshot-version" will associate the existing embed with a snapshot of the current state of the document, even if the embed was already associated with an older snapshot of the document.

📘
Updating the version of an existing document embed with version type snapshot-version can't be undone! There is no way to revert an embed to a previous snapshot version.

Valid Authentication Methods

OAuth 2.0 User Token and Account Token Scopes:

lucidchart.document.content.share.embed
lucidchart.document.app.picker.share.embed
lucidscale.document.content.share.embed
lucidscale.document.app.picker.share.embed
lucidspark.document.content.share.embed
lucidspark.document.app.picker.share.embed

Responses

400

Bad Request. Occurs if the embed version provided in the request body is invalid.

403

Forbidden. Occurs when the access token isn't allowed to change the embed version.

Updating the version of an existing document embed with version type snapshot-version can't be undone! There is no way to revert an embed to a previous snapshot version.

Valid Authentication Methods

OAuth 2.0 User Token and Account Token Scopes:

200OK. Returns a Document Embed Resource containing information about the updated document embed.

Updating the version of an existing document embed with version type `snapshot-version` can't be undone! There is no way to revert an embed to a previous snapshot version.