• DocsDocs
  • PricingPricing
Book a demo
Sign in
Sign in
Book a demo
    • Ready-made features
      • AI Copilots
        AI Copilots

        In-app AI agents that feel human

      • Comments
        Comments

        Contextual commenting

      • Multiplayer Editing
        Multiplayer Editing

        Realtime collaboration

      • Notifications
        Notifications

        Smart alerts for your app

      • Presence
        Presence

        Realtime presence indicators

    • Platform
      • Monitoring Dashboard
        Monitoring Dashboard

        Monitor your product

      • Realtime Infrastructure
        Realtime Infrastructure

        Hosted WebSocket infrastructure

    • Tools
      • Examples

        Gallery of open source examples

      • Next.js Starter Kit

        Kickstart your Next.js collaborative app

      • DevTools

        Browser extension for debugging

      • Tutorial

        Step-by-step interactive tutorial

      • Guides

        How-to guides and tutorial

    • Company
      • Blog

        The latest from Liveblocks

      • Customers

        The teams Liveblocks empowers

      • Changelog

        Weekly product updates

      • Security

        Our approach to security

      • About

        The story and team behind Liveblocks

  • Docs
  • Pricing
  • Ready-made features
    • AI Copilots
    • Comments
    • Multiplayer Editing
    • Notifications
    • Presence
    Platform
    • Monitoring Dashboard
    • Realtime Infrastructure
    Solutions
    • People platforms
    • Sales tools
    • Startups
    Use cases
    • Multiplayer forms
    • Multiplayer text editor
    • Multiplayer creative tools
    • Multiplayer whiteboard
    • Comments
    • Sharing and permissions
    • Document browsing
  • Resources
    • Documentation
    • Examples
    • React components
    • DevTools
    • Next.js Starter Kit
    • Tutorial
    • Guides
    • Release notes
    Technologies
    • Next.js
    • React
    • JavaScript
    • Redux
    • Zustand
    • Yjs
    • Tiptap
    • BlockNote
    • Slate
    • Lexical
    • Quill
    • Monaco
    • CodeMirror
  • Company
    • Pricing
    • Blog
    • Customers
    • Changelog
    • About
    • Contact us
    • Careers
    • Terms of service
    • Privacy policy
    • DPA
    • Security
    • Trust center
    • Subprocessors
  • HomepageSystem status
    • Github
    • Discord
    • X
    • LinkedIn
    • YouTube
    © 2025 Liveblocks Inc.
Blog/Updates

Extend the capabilities of Yjs using our REST API and webhooks

Today, we'll dive into the different ways Liveblocks enables developers to extend Yjs, allowing you to integrate your document data seamlessly into existing systems with our REST API and webhooks.

on September 7th, 2023
Extend the capabilities of Yjs using our REST API and webhooks
September 7th, 2023·3 min read
Share article

In recent years, Yjs has grown to be the preferred way for developers to build collaborative rich text editors owing to its powerful features such as multiplayer undo/redo, lazy loading subdocuments, and offline support.

If you’ve already built collaborative experiences with Yjs, then you’ve probably discovered that integrating it with other parts of your system can be challenging. Because every update gets stored, Yjs documents can be hard to index, parse, and tend to grow quickly in size over time.

Today, we’ll dive into the different ways Liveblocks enables developers to extend Yjs capabilities in order to integrate Yjs data seamlessly into an exising system.

Update and retrieve documents with the REST API

Liveblocks provides access to a REST API, and with the launch of Liveblocks Yjs we’ve included some new endpoints specifically for Yjs.

Get Yjs documents

With the Get Yjs Document API you can retrieve Yjs document data for any given room.

const roomId = "my-room-name";fetch(`https://api.liveblocks.io/v2/rooms/${roomId}/ydoc`);

The result of the query will be in JSON form—though note that the exact schema will be different for each editor.

{  "my-y-text": "Content of my yText field"}

We also have an API for getting a Yjs document as a binary update.

Update Yjs documents

It’s possible to update a Yjs document by REST API, using the Send a Binary Yjs Update API. Here’s a code snippet, showing how it works.

// Create a Yjs documentconst yDoc = new Y.Doc();
// Create your data structures and make your updateconst yText = yDoc.getText("my-y-text");yText.insert(0, "Hello world");
// Encode the document state as an update messageconst yUpdate = Y.encodeStateAsUpdate(yDoc);
const roomId = "my-room-name";await fetch(`https://api.liveblocks.io/v2/rooms/${roomId}/ydoc`, { method: "PUT", body: yUpdate,});

If you’re interested in using this, make sure to read our full guide on the topic:

  • Modifying Yjs document data with the REST API

Use Yjs triggered webhook events

We’ve added new Yjs-triggered events to our Webhooks enabling you to automatically perform custom actions in your back end, such as sending notifications or saving your data to a database. This can all be implemented this by listening to the YDocUpdatedEvent, which runs whenever a Yjs document is modified.

Yjs webhook events sent to your backend.

Yjs webhook events - YDocUpdatedEvent

Our previous webhooks continue to work with Yjs too, for example you can respond to rooms being created and deleted, or users entering and leaving rooms.

Synchronizing Yjs document data to databases

When our webhooks and REST API are combined, it makes it easy to synchronize your Yjs document with a database. Here are some detailed guides on how to synchronize your Yjs document data to various databases:

  • Synchronize Yjs with PlanetScale MySQL
  • Synchronize Yjs with Vercel Postgres
  • Synchronize Yjs with Supabase Postgres

This is just one possibility, out platform enables many use cases. For example:

  • Parsing document data to notify users mentioned in a document.
  • Recording a version history of your documents.
  • Indexing your documents for a search form.

For the first time, this is now achievable with ease.

The most advanced platform for Yjs

Liveblocks is already the most advanced platform for Yjs, yet we have plans to extend Yjs even further, and we’re busy working on them right now—make sure to check back soon. We’re excited to see what you build with Liveblocks Yjs.

How to guides

Ready to get started?

Join thousands of companies using Liveblocks ready‑made collaborative features to drive growth in their products.

Book a demo

Related blog posts

  • What's new in Liveblocks: August 2025

    What's new in Liveblocks: August 2025

    Picture of Chris Nicholas
    September 17th
    Updates
  • What’s new in Liveblocks: July 2025

    What’s new in Liveblocks: July 2025

    Picture of Chris Nicholas
    August 5th
    Updates
  • What’s new in Liveblocks: June 2025

    What’s new in Liveblocks: June 2025

    Picture of Chris Nicholas
    July 15th
    Updates