Hey Lucid Devs! 👋
We’re excited to introduce Editable Embeds—a new way to integrate Lucid documents directly into your web applications! 📝 Now you can embed Lucid documents that are not just viewable but fully editable with our token-based embed solution, allowing for seamless collaboration right within your own platform.
Why Editable Embeds?
By embedding the Lucid experience in other apps, you can improve documentation and minimize the need to switch between apps. With Editable Embeds, you can:
- Enable users to edit and collaborate on Lucid documents directly within your app.
- Streamline development and testing with an easy-to-use embedding process.
- Add comprehensive diagramming and collaboration tools to your application.
🛠 How to Get Started
Put simply, here’s the setup: create an application > obtain an access token > generate an embed session token > embed the viewer in your app > configure “editable” access level. See the details (and example implementations!) in our Token-based External Embeds Guide!
🔒 Are There Admin Controls?
Yes! Admins have the ability to enable or disable Editable Embeds for their organization. They can also manage permissions and access levels to ensure everything stays secure and compliant.
🚨 Important Notes
- Editable Embeds utilize OAuth 2.0. Make sure to securely manage and store your tokens within your application.
- When embedding documents, set the appropriate access levels (Edit, Comment only, or View only) during the embedding process. Editable embeds require the user to have editing permissions, so your app could enforce permission checks when generating embed tokens.
- Only token-based embeds allow editing; use this option if your users need full collaboration capabilities. For simpler, view-only embeds, the cookie-based approach works but requires users to already have permissions in Lucid and will need third-party cookies enabled.
We look forward to seeing how you implement Editable Embeds in your projects! Comment below to let us know your feedback, and don't hesitate to reach out if you have any questions! 💬
Happy coding! 🧑💻
— Lucid API Team
