DAM Integration API

 
The DAM integration API is an add-on available to business subscriptions. 
 

Digital asset management (DAM) systems help companies control the management, organization, and dissemination of digital assets, and they generally serve as a single source of truth for certain brand-related content. Many Lucidpress accounts use DAMs to store and organize their brand images, graphics, stock photos, and other digital assets. With the Lucidpress DAM API, accounts can import and utilize these DAM-hosted images within Lucidpress while maintaining centralized control within the DAM.

 

Preparing and hosting DAM data
Learn how to transform DAM data prior to integration.

Accounts using the Lucidpress DAM API must transform their DAM data prior to integration. The DAM data must conform to the Lucidpress JSON format (see below). Once the transform is complete, accounts must host the corresponding JSON file on a server and generate a public URL to access that file. Any future changes to the DAM should be reflected in the JSON file, which the API will reference daily to update the images, folders, and tags that appear within Lucidpress.
{
version: number,
    
data: folder[]
}

image: {
id: string,
name: string,
tags: string[],
url: string,
thumbnailUrl: string
}

folder: {
id: string,
name: string,
folders: folder[],
images: image[]
}
{
	"version": 1,
	"data": [{
		"id": "100",
		"name": "Lucid Logos",
		"folders": [{
			"id": "102",
			"name": "Lucidpress",
			"folders": [],
			"images": [{
				"id": "200",
				"name": "Lucidpress Logo",
				"tags": ["logo", "press", "lucidpress"],
				"url": "app.lucidpress.com/press.jpeg",
				"thumbnailUrl": "app.lucidpress.com/pressThumbnail.jpeg"
			}, {
				"id": "201",
				"name": "Wide Lucidpress Logo",
				"tags": ["logo", "press", "lucidpress", "wide"],
				"url": "app.lucidpress.com/pressWide.png",
				"thumbnailUrl": "app.lucidpress.com/pressWideThumbnail.png"
			}]
		}, {
			"id": "103",
			"name": "Lucidchart",
			"folders": [],
			"images": [{
				"id": "202",
				"name": "Lucidchart Logo",
				"tags": ["logo", "chart", "lucidchart"],
				"url": "app.lucidchart.com/chart.jpeg",
				"thumbnailUrl": "app.lucidchart.com/chartThumbnail.jpeg"
			}]
		}],
		"images": [{
			"id": "203",
			"name": "Lucid L",
			"tags": [],
			"url": "www.golucid.co/lucidL.png",
			"thumbnailUrl": "www.golucid.co/lucidLThumbnail.png"
		}]
	}, {
		"id": "101",
		"name": "Other",
		"folders": [],
		"images": []
	}]
}
The DAM API uses image dimensions—among other information—to check for deleted images that have been reuploaded for the purpose of restoring those images in their respective documents. The API collects this information by sending HEAD requests to the server hosting the DAM images. Accordingly, in order for restore functionality to work, the server hosting the DAM images must permit HEAD requests on all image resources.

 

Connecting your DAM
Learn how to connect a DAM to your Lucidpress account.

Once you’ve transformed your DAM data, produced an associated JSON file, and generated a URL to access that file, connecting a DAM to your account is as simple as adding the associated URL to the DAM integrations page. To start, navigate to the admin panel by selecting the Team tab in the Lucidpress homepage. Then click App Integration > Digital Asset Manager.

Image_1_-_Digital_Asset_Manager_Tile.png
On the DAM integration page, select Add DAM.
Image_2_-_DAM_Integration_Page__Blank_.png

After you select Add DAM, a tile will appear that contains two text fields: (1) DAM Name and (2) JSON URL. For the DAM name, enter whichever name you’d like to appear as the top-level folder in the DAM folder tree. This could be the name of the DAM itself or it could describe the content within the DAM (e.g., “Stock Photos”). Of note, this name will appear as the top-level DAM folder for all users on the account.

Image_3_-_DAM_Integration_Page__DAM_Name_.png
Next, add the URL to access the JSON file within the JSON URL field.
Image_4_-_DAM_Integration_Page__JSON_URL_.png
Once you’ve completed these steps, click Save. Assuming the JSON file matches the API schema, the API will begin processing the file and syncing the DAM.

Image_5_-_DAM_Integration_Page__Synced_DAM_.png
Although sync time largely depends on the number of images in the DAM, the sync should generally take no longer than five minutes.
Once the initial sync is complete, the API will automatically resync the DAM every 24 hours. Upon syncing, any changes made to the DAM during the period between syncs will be reflected within Lucidpress.

If desired, you can also manually sync your DAM. Use this feature if you’d like to push DAM changes to Lucidpress sooner than would occur with the daily sync. To manually sync a DAM, navigate to the admin panel by selecting the Team tab in the Lucidpress homepage. Then click App Integration > Digital Asset Manager.
Image_1_-_Digital_Asset_Manager_Tile.png

On the DAM integration page, click the gear icon in the top-right corner and select Manual Sync. Of note, manually syncing a DAM will not disrupt or reset the automatic syncing schedule.
Image_6_-_DAM_Integration_Page__Manual_Sync_.png
Deleting a DAM will permanently remove the DAM and its associated data from your team’s account. All images used from the DAM will be removed from their respective documents and replaced with a placeholder image. To remove a DAM from your account, navigate to the admin panel by selecting the Team tab in the Lucidpress homepage. Then click App Integration > Digital Asset Manager.
Image_1_-_Digital_Asset_Manager_Tile.png

Next, hover over the DAM tile you’d like to delete. Select the pencil icon that appears to the far-right of the tile.
Image_7_-_Collapsed_DAM_Tile__Pencil_Icon_.png

Once the DAM tile is expanded, select the trash icon in the top-right corner. A confirmation dialog will appear. Review the message within the dialog, and then select “Delete” to remove the DAM from your account.
Image_8_-_Expanded_DAM_Tile__Trash_Can_.png
Image_9_-_Delete_DAM_Confirmation_Dialog.png

 

Using DAM images
Learn how users will access and use DAM images within Lucidpress.

Each DAM connected to your account will appear as a separate folder tree within every user’s Image Manager. The name of the top-level folder in the DAM folder tree will be whichever name you specified when you initially connected the DAM.
Image_10_-_Images_Tab_Pane.pngImage_11_-_Image_Manager.png
To change the name of the top-level folder in the DAM folder tree, simply return to the DAM integration page in the admin panel and edit the name within the relevant DAM tile.
Image_4_-_DAM_Integration_Page__JSON_URL_.png
DAM images use the same drag-and-drop functionality as all other images in Lucidpress. To use a DAM image, navigate to the Images tab in the content pane in the editor. In the dropdown menu, select your DAM. Images will then populate within the content pane. Simply drag images directly from the content pane onto the canvas.
Image_12_-_Content_Pane__Dropdown_.pngImage_13_-_Content_Pane__DAM_.png

Alternatively, you can access DAM images from the Image Manager. To access the Image Manager, navigate to the Images tab in the content pane and select the Manage button in the top-right corner of the pane.
Image_14_-_Content_Pane__Manage_.png
Once you’ve opened the Image Manager, navigate to the DAM folder tree . You can insert images by double-clicking an image or by single-clicking a image and selecting Insert. 
Image_15_-_Image_Manager__Image_Selected_.png
DAM images use the same tag functionality as personal images in Lucidpress. To use tags to search for assets, navigate to the relevant DAM folder in the Images tab in the homepage or the Image Manager in the editor. Next, select the Tags dropdown and click one or more tags in order to filter DAM assets. 
Image_16_-_Tags.png

 

Tracking and replacing deleted images
Learn how to identify which documents and templates contained deleted images.

Any changes to the DAM in terms of folder structure, image content, and tags will be reflected in Lucidpress following the proceeding sync. This means that any images deleted from the DAM will be removed from their respective documents and replaced with a placeholder image. The API tracks and automatically displays all documents and templates that contained now-deleted DAM images. This lets you quickly identify and fix any documents and templates affected by deleted images.
Lucidpress will display a unique icon on any documents or personal templates that contained an image that has since been deleted from the DAM. Users can update the images within the affected documents, ignore the notification, or return to the original brand template and create a new document (assuming the image has been updated in the Brand Template). 
Image_17_-_Missing_Images_Icon.png
Lucidpress will show a distinct Update Templates page in the Templates tab that displays a list view of all Brand Templates that are missing images. This page appears only if there are Brand Templates that are missing images, and it is visible to the account owner and template admins only.
Image_18_-_Update_Templates_Page.png
In addition to the Update Templates page, Lucidpress will show an updated header on all Brand Templates that are missing images. These headers are visible to the account owner and template admins only.
Image_19_-_Missing_Images_Header.png
Lucidpress will also send an email notifying the account owner and template admins any time Brand Templates are affected by new deletions from the DAM. This email will redirect admins to the Update Templates page within the Templates tab.
Replacing a deleted image and resolving a document or template is as simple as adding a new image to the associated placeholder block. These placeholder blocks appear as “gray mountains” within a document. Adding new images to all placeholder blocks will remove the associated document or template from the list of documents that are missing images.
Image_20_-_Placeholder_Block.png

 

Restoring deleted images
Learn how to restore images that were deleted from the DAM.

All images deleted from the DAM will be removed from their respective documents and replaced with a placeholder image. This functionality lets accounts maintain centralized control in the DAM; however, it means that mistakes and accidental deletions from the DAM can directly impact your documents in Lucidpress. For this reason, the API provides built-in image restore functionality to help accounts quickly fix errors.
To restore a deleted image within its respective documents and templates in Lucidpress, simply reupload the deleted image to the DAM. Upon syncing, the API will use the image content to determine whether that image was used in any documents or templates that contain a placeholder block. If it finds associated placeholder blocks, it will restore the image. Of note, restore functionality will not work if you add new images to the placeholder blocks associated with the deleted image.
The DAM API uses image dimensions—among other information—to check for deleted images that have been re-uploaded for the purpose of restoring those images in their respective documents. The API collects this information by sending HEAD requests to the server hosting the DAM images. Accordingly, in order for restore functionality to work, the server hosting the DAM images must permit HEAD requests on all image resources.

 

Additional features
Learn more about error detection, authentication, and manual syncing.

Any changes to the DAM in terms of folder structure, image content, and tags will be reflected in Lucidpress following the proceeding sync. This means that any images deleted from the DAM will be removed from their respective documents and replaced with a placeholder image. Due to the potential impact of this operation, the API provides built-in error detection that stops a sync if we detect a significant change in the number of images in your DAM.

Specifically, if the API detects a change of 10% of greater between syncs, it will pause automatic syncing and send a notification to the account owner and all data admins. This percentage is based on total images in the DAM and measures only deleted images (i.e., images detected in the previous sync that no longer appear in the JSON file). An admin must then review and approve the detected deletions and ensure they are accurate and intentional. Upon approving changes, the API will resume automatic syncing.
While the API relies on public URLs to pull images from the DAM, accounts have the option to add basic authentication. Specifically, your server can request authorization to access the JSON file, and the API will provide the required username and password. Please contact your Lucidpress customer success representative for more information on how to set up basic authentication for your DAM.
If desired, you can manually sync your DAM. Use this feature if you’d like to push DAM changes to Lucidpress sooner than would occur with the daily sync. To manually sync a DAM, navigate to the admin panel by selecting the Team tab in the Lucidpress homepage. Then click App Integration > Digital Asset Manager.
Image_1_-_Digital_Asset_Manager_Tile.png
On the DAM integration page, click the gear icon in the top-right corner and select Manual Sync. Of note, manually syncing a DAM will not disrupt or reset the automatic syncing schedule. 
Image_6_-_DAM_Integration_Page__Manual_Sync_.png

 

FAQs

No. All users will be restricted from adding, moving, or deleting DAM images, folders, and tags within Lucidpress. These restrictions help accounts maintain centralized control within the DAM.
Any changes to the DAM in terms of folder structure, image content, and tags will be reflected in Lucidpress following the proceeding sync. This means that any images deleted from the DAM will be removed from their respective documents and replaced with a placeholder image.
For documents and personal templates, Lucidpress will display a unique icon on any documents that contained an image that has since been deleted from the DAM. Users can update the images within the affected documents, ignore the notification, or return to the original brand template and create a new document (assuming the image has been updated in the Brand Template).
Image_17_-_Missing_Images_Icon.png

For Brand Templates, Lucidpress will show a distinct Update Templates page in the Templates tab that displays a list view of all Brand Templates that are missing images. This page appears only if there are Brand Templates that are missing images, and it is visible to the account owner and template admins only. Lucidpress will also send an email notifying the account owner and template admins any time Brand Templates are affected by new deletions from the DAM.
Image_18_-_Update_Templates_Page.png
In addition to the Update Templates page, Lucidpress will show an updated header for any Brand Templates that are missing images. These headers are visible to the account owner and template admins only. 
Image_19_-_Missing_Images_Header.png
Yes! Many Lucidpress accounts use multiple DAMs to store different types and categories of assets. Business-level accounts that have purchased the DAM integration add-on can integrate as many DAMs as they’d like. Each DAM will appear as a separate folder tree within each user’s Image Manager.
Lucidpress will import all image tags provided in the DAM JSON file. You can use these tags to search for assets the same way you would in your DAM. Although the JSON schema asks for folders, these fields can be left blank.
Deleting a DAM will permanently remove the DAM and its associated data from your team’s account. All images used from the DAM will be removed from their respective documents and replaced with a placeholder image.
Although sync time largely depends on the number of images in the DAM, the sync should generally take no longer than five minutes.

 

 
 
Was this article helpful?
0 out of 0 found this helpful