These docs are for v1.0. Click to read the latest docs for v1.2.

Embed Viewer

Display an embed within an <iframe>. If no embed id was included when creating the token, the <iframe> first displays a document picker where the user can create and configure a new embed.If embed id was included, the <iframe> displays an embedded document viewer or an embed configuration page for the associated document.It supports both Account and User token types.

Document Embedding Event

Below is a list of possible events via postMessage sent to the parent window:

The EmbedCreated event

Fired when a new embed is created by the user.

PropertyTypeDescription
typeString"LucidEmbedEvent"
eventString"EmbedCreated"
documentIdUUIDID of the selected document.
embedIdStringID of the newly created document embed.
signatureStringSignature of the newly created document embed.

The SettingsClosed event

Fired when the embed settings are updated by the user.

PropertyTypeDescription
typeString"LucidEmbedEvent"
eventString"SettingsClosed"
settingsUpdatedBooleantrue if the user changed the embed settings.

The OpenCustomSettings event

Fired when the "Settings for " button is clicked by the user.

PropertyTypeDescription
typeString"LucidEmbedEvent"
eventString"OpenCustomSettings"
Query Params
string
required

The embed session token retrieved from the Generate Embed Session Token endpoint.

Headers
string
required
Defaults to 1

The API version used in the request.

Responses

401

Unauthorized. The token is missing or invalid.

403

Forbidden. The access to the embed is forbidden.

404

Not Found. The embed id is not found.

Language
Credentials
OAuth2