Workflow & agent

Toolkit slug: flowra (main Flowra toolkit). These tools map to the Workflows and Triggers APIs. Rows are scoped by ownerEUID (multi-tenancy) — send x-username per end user. For concepts (workflowType: static vs agent, when to use each, how runs differ), see Workflows and agents. This page is the native tool slug reference only.

Native tools are what agents call by slug. For REST CRUD and execute, use the Workflows guide and API reference.

Which native tool to use?

Goal	Tool
Fixed multi-step automation	`FLOWRA_CREATE_OR_UPDATE_WORKFLOW`
Chat / AI picks tools	`FLOWRA_CREATE_OR_UPDATE_AGENT`
Run on schedule or webhook	`FLOWRA_MANAGE_TRIGGER` → link `triggerId` in create
Test a static flow	`FLOWRA_EXECUTE_WORKFLOW`
Chat with an agent	Threads / Graphify — not `EXECUTE_WORKFLOW`
Pause for approval	`human_wait` node on static graphs — Human in the loop

Tools reference

Slug	Name	`workflowType`	What it does
`FLOWRA_CREATE_OR_UPDATE_WORKFLOW`	Create or Update Workflow	Sets `static`	LangGraph-style graph: `action`, `code`, `llm_agent`, `start`, `end`, `human_wait` nodes.
`FLOWRA_CREATE_OR_UPDATE_AGENT`	Create or Update Agent	Sets `agent`	Top-level conversational agent (prompt, model, tools).
`FLOWRA_GET_WORKFLOW_OR_AGENT_BY_ID`	Get Workflow or Agent By ID	Both	Full detail; response shape depends on type.
`FLOWRA_LIST_WORKFLOWS`	List Workflows	Both	Filter with `workflowType: static` or `agent`.
`FLOWRA_DELETE_WORKFLOW`	Delete Workflow	Both	Soft-delete (confirmation step; restricted via MCP in some cases).
`FLOWRA_MANAGE_TRIGGER`	Manage Trigger	N/A (trigger instance)	Register / enable / disable / delete `trigger_tool` instances.
`FLOWRA_EXECUTE_WORKFLOW`	Execute Workflow	`static` only	Test (`testMode: true`, mocked tools) or production run. Fails if ID is an agent.
`FLOWRA_LIST_AI_MODELS`	List AI Models	N/A	Models for `modelSettings` when creating agents or `llm_agent` nodes.

Triggers via `MANAGE_TRIGGER`

Action	When
`register`	Create or update instance — needs `toolSlug`, `workspaceId`, `triggerToolInput`
`enable` / `disable`	Pause or resume — needs `triggerId`
`delete`	Remove instance — needs `triggerId`

Link the instance: trigger: { kind: "trigger_tool", toolSlug, triggerToolInput, triggerId }.

Workflows and agents — Canonical concepts
Native tools overview
Workflows
Triggers
Threads — run agents
Human in the loop
Multi-tenancy

Getting started

Core building blocks

Data and runtime

Integrate and scale

Recipes

Native tools

Contributing

Workflow & agent

Which native tool to use?

Tools reference

Triggers via `MANAGE_TRIGGER`

​Which native tool to use?

​Tools reference

​Triggers via MANAGE_TRIGGER

​Related

Which native tool to use?

Tools reference

Triggers via `MANAGE_TRIGGER`

Related