Documentation
Two collections, split by who is reading. Running a business on Vendu is one job; building on top of it is another.
Product
7 pagesSet up channels, load a catalog, teach the agent, and understand what it does on its own.
- What Vendu doesWhat the AI agent handles on its own, where it hands over to a human, and what you have to set up first.
- How the agent decides what to sayThe steps between a customer's message and the reply they receive, and where each one can stop the agent.
- Roles and permissionsWhat each of the four workspace roles can do, and which actions only the owner can take.
- The order lifecycleEvery status an order can be in, which moves are allowed, and which three are final.
- Triggers and actionsEvery event a workflow can start from and every action it can take, with the conditions each one needs.
- What apps areHow an app adds something Vendu does not do out of the box, and what one can and cannot change.
- When the agent hands overWhat makes the agent stop and ask for a person, what you receive when it does, and how to change the threshold.
Developers
9 pagesThe REST API, webhooks, and how to extend Vendu with your own app.
- Build on VenduWhat you can build on Vendu — REST integrations, outbound webhooks, apps that extend the agent, and MCP access.
- API error codesEvery error code the Vendu API returns, what causes it, and how to recover from it.
- Make your first API callHow to create an API key and call the Vendu REST API from curl, JavaScript, Python or Go.
- MCP serverHow to connect Vendu to Claude, Cursor or any MCP client so an AI assistant can work with your workspace.
- Migrate from offset to cursor paginationHow to move a list integration from offset pagination to cursors without dropping or repeating rows.
- Outbound webhooksEvent types Vendu delivers to your endpoint, the payload shape, and how delivery is retried.
- Rate limitsRequest quotas per API key, the headers that report remaining budget, and what happens at the limit.
- Versioning and deprecationHow the Vendu API changes over time and how much notice you get before something is removed.
- Build an appHow to extend Vendu with your own tools, records, knowledge and screens without changing its core.