Benchling Integration
Latch Registry allows you to perform a one-way sync to bring entities from Benchling Registry and Benchling Inventory to Latch Registry as tables.
Once Benchling data is transformed into table forms on Latch, you can:
- Easily search, sort, filter, and join data across tables.
- Directly sync sequences from Benchling Protein entities, for example, and kick-start hundreds of AlphaFold2 for protein prediction or DNA Chisel for codon optimization.
This document walks through the process of setting up the Benchling one-way data sync to the Latch Registry.
Setup Benchling Sync
The integration works by using your Benchling developer API key.
- Follow the official Benchling tutorial to get your personal user API key.
- In Latch Console, go to Workspace Settings > Developer, and click on
Benchling
. - For
BENCHLING_TENANT_URL
enter your tenant URL. Ex.https://latch.benchling.com/
.
Note: Include the full tenant URL including
https://
.
- For
BENCHLING_API_KEY
, enter your Benchling API key that you got from step 1. Ex.sk_example_key
- Click
Submit
to save your Benchling credentials which will securely store your credentials in Amazon Secrets Manager. - You will see your Benchling secrets added to the
Workspace Secrets
section.
Syncing Data Using Benchling Sync
After successfully adding your Benchling credentials to Latch, you can go to the Latch Registry and sync your Benchling data to a new project on Latch.
Note: Only one-way sync from Benchling to Latch is supported at the moment.
-
Go to
Registry
. -
Create a new project by clicking
New Project
in the sidebar. -
Click on
Benchling Data Sync
in the top right corner. -
Select the project to sync data into.
-
Use the selector to switch between Plate and Entity schemas.
-
Check the Benchling Schemas and columns that you want to sync. These schemas will be synced into the tables under the project that you have selected in step 4. If the entity schema you selected links to other schemas, the related schemas will be automatically selected for an sync as well. This is to ensure the parent-child relationships in Benchling are also propagated to Latch Registry tables.
-
(Optional) Enable automatic sync. If this option is enabled, your data will be automatically synced from Benchling to Latch every 30 minutes.
-
Click
Save Sync Settings
to save the state of your sync. -
Click
Manual Sync
to manually sync all the schemas that you have selected into Latch. Depending on the size and the amount of schemas that you are syncing, this might take a couple of minutes. Please keep the tab with the sync open. If you need to use the rest of the platform, please open a new tab and go to the Console page there. -
After the sync exits, all of the schemas that you have selected will be available in the specified project.
Was this page helpful?