Workflows
Building, deploying, and managing workflows.
Workflows
A Workflow is the core unit of automation in Linea. It defines a sequence of steps — nodes connected by edges — that run together as a single execution.
Lifecycle
| State | Meaning |
|---|---|
| Draft | In progress, not yet runnable from triggers |
| Deployed | Live — can be triggered by schedules, webhooks, or the API |
| Trashed | Soft-deleted — can be restored |
Only deployed workflows can be triggered automatically. Drafts can still be run manually from the preview panel.
API Endpoints
| Method | Path | Description |
|---|---|---|
GET | /workspaces/:wId/pods/:pId/workflows | List workflows (?starred=true, ?trashed=true) |
POST | /workspaces/:wId/pods/:pId/workflows | Create workflow |
GET | /workspaces/:wId/pods/:pId/workflows/:id | Get workflow |
PATCH | /workspaces/:wId/pods/:pId/workflows/:id | Update name, description, or definition |
PATCH | /workspaces/:wId/pods/:pId/workflows/:id/star | Toggle starred |
PATCH | /workspaces/:wId/pods/:pId/workflows/:id/trash | Move to trash |
PATCH | /workspaces/:wId/pods/:pId/workflows/:id/restore | Restore from trash |
Node types
Workflows are built from nodes. Each node performs a specific action:
| Category | Node | What it does |
|---|---|---|
| Core | Start | Entry point — receives trigger input |
| Core | End | Outputs the final result |
| AI | Agent | Runs an LLM with tool use and structured output |
| AI | Memory | Read or write persistent memory |
| Logic | If / Else | Branch based on a condition |
| Logic | Router | Route to multiple paths |
| Tools | HTTP | Call any external REST API |
| Tools | MCP | Use a connected Model Context Protocol server |
| Data | Transform | Reshape variables with a JS expression |
| Data | Extract | Scrape web content |
| Data | Retriever | Query a knowledge base |
| Safety | Guardrails | PII detection and content filtering |
| Safety | Code | Run sandboxed JavaScript |
| Flow | Loop | Iterate over an array |
| Flow | Sub-workflow | Call another workflow and wait for its result |
| Integrations | Slack | Send messages or DMs |
| Integrations | GitHub | Create issues, comments, and PRs |
| Integrations | Notion | Create pages and query databases |
| Integrations | Gmail | Send and read email |
| Human-in-loop | Approval Gate | Pause and wait for a human to approve or reject |
See the Node Reference for full configuration details on each type.
Building a workflow
Open the visual builder from the dashboard. Drag nodes from the library panel onto the canvas, connect them with edges, and configure each node in the side panel. Click Deploy when ready.
The Chat Preview panel lets you run the workflow immediately — in text mode or JSON simulation mode — without deploying first.