Handle TipTap collaboration webhook events by persisting document content changes to Supabase and updating source citation references.

Skips processing for non-DOCUMENT types, empty content, and content that is identical to the current version (avoiding unnecessary writes). Emits structured [files-sync] lifecycle logs with timing for observability.

post/api/py/files/sync

Request

  • Base URL
    https://api.getauctor.com (the document declares no server; this is the origin it was published from)
  • URL
    https://api.getauctor.com/api/py/files/sync
  • Auth
    none declared

Request body

app_namestring required
namestring required
timestring required
tiptap_jsonobject
ydoc_statestring nullable
clients_countinteger
typestring nullable
triggerstring nullable
usersstring[] nullable
userstring nullable
commentobject nullable

Response

Successful Response

successboolean required
version_idstring nullable

Changes

    • breaking

      the request property's minLength was increased from 0 to 1

    • info

      request property list-of-types was widened by adding types array to media type application/json