skip to main content
Browse documentation

The headless SDK

Build a completely custom chat UI on top of Syncanix, without mounting the widget.

If the widget’s UI isn’t what you want, you can build your own. The headless SDK gives you the engine without any interface.

What it is

A headless client that exposes everything the widget uses internally, so you can render your own UI around it:

  • The streaming message flow.
  • The conversation state machine.
  • Tool calls and their lifecycle.
  • Your resolved theme tokens, if you want to match the rest.

When to use it

Reach for the headless SDK when you need a fully bespoke chat surface — a custom layout, your own component system, or an experience embedded deep in your product. For most teams the standard widget is faster; the headless path is there when you outgrow it.

Next steps