Developer API
13references · REST API for building integrations
Everything you need to integrate Sarufi chatbots into your applications via REST API.
Getting Started
Build chatbots, manage flows, and connect channels with the Sarufi REST API.
Authentication
Authenticate API requests using your workspace Bearer token.
Workspace
Verify your API key and retrieve workspace information.
Chatbots
Create, list, retrieve, update, and delete chatbots in your workspace.
Flows
Create and manage conversation flows and meta flows for a chatbot.
Conversations
List and inspect conversations and messages for a chatbot.
Chat
Create chat sessions and send messages to interact with published chatbot flows via API.
Integrations
Connect chatbots to WhatsApp, REST API, web widget channels, and external MCP tool servers.
Knowledge Bases
Create and manage knowledge bases, add sources, and connect them to chatbots.
Analytics
Retrieve conversation and message metrics for a chatbot.
MCP Server Integration
Register remote MCP servers as LLM agent tools via the Model Context Protocol.
How Flows Work
Understand the flow system — states, transitions, variables, and action types — and how the conversation engine uses them to drive a chat.
Connecting to Your Backend
Use the API_CALL action to fetch data, submit forms, and trigger operations in your own systems from inside a conversation flow.