Flowblocks
Dashboard
v0.1.0GitHub []


Developer
Documentation

Flowblocks adds agent workflows to your product. These docs cover the builder, the step types, connectors, the SDKs and self-hosting.

Start here

Build your first workflow

Describe a workflow or draw it step by step, connect a tool, and run it in the preview chat.

Connectors

Read access to Gmail, Drive, Dropbox, Teams, Outlook and SharePoint, plus any MCP server.

Reference

Self-hosting, environment variables, limits and common questions.

Getting Started

Build a first workflow and learn how a run moves through it.

Quickstart

Build a workflow, connect a tool, and run it in the preview chat. Takes about five minutes.

How it works

How a message moves through a workflow, what each step receives, and what gets recorded.

Building Workflows

The canvas, generating a graph with Ask AI, the preview chat, and sharing.

The canvas

Add steps from the palette, connect them, and configure each one in the side panel.

Generating with AI

Describe a workflow and Ask AI drafts the graph. Keep asking to change it or compare versions.

Preview and runs

Test a workflow in the preview chat, answer its approvals, and inspect each step of a run.

Sharing and collaboration

Invite people with a view or comment role, edit together live, or publish a public link.

Steps

The twelve step types: agents, tool calls, branches, loops, guardrails and approvals.

Overview

The twelve step types, what each one does, and which ones can branch a run.

Agent

Calls a model from OpenAI, Anthropic or xAI. Set its instructions, tools and output format.

Branches and loops

If / else and While steps, the CEL expressions that drive them, and the loop limits.

Guardrails and approval

Screen messages for personal data and jailbreaks, and pause a run until a person approves.

State and data

Reshape output with Transform, keep values with Set state, and search uploaded files.

Connectors

Built-in connectors for Google, Dropbox and Microsoft, plus any MCP server.

Overview

The 54 built-in connectors, how an account gets connected, and how tokens are stored.

Google

Register one Google Cloud OAuth client for all eleven Google connectors.

Microsoft

Register one Entra app for all eleven Microsoft connectors.

Dropbox

Register a Dropbox app with three read scopes and one redirect URI for the Dropbox connector.

Other providers

Register the OAuth app behind each of the other 31 providers, with its scopes, callback and caveats.

MCP servers

Add any MCP server that speaks HTTP, store its token, and pick which tools a step may call.

Develop

The React component for embedding the builder, the Node SDK and the REST API.

Embedding the builder

Render the builder inside your own app with the WorkflowBuilder React component.

Node SDK

Start a workflow run from your backend with the TypeScript SDK and read the result.

REST API

Start a run with one HTTP request. Covers authentication, the request body and the response.

Reference

Self-hosting, environment variables, limits and common questions.

Self-hosting

Run Flowblocks locally or on your own infrastructure with Node.js and Postgres.

Environment variables

Every variable a self-hosted install reads, with its default and what it controls.

Limits

Caps on steps, tokens, loops, files and requests, and which ones you can raise.

FAQ

Pricing, supported models, where credentials are stored, and other common questions.