ActionFlowsCopy Anchor Link

Discover ActionFlows you already designed in the app. The SDK returns metadata only (id, name, slug, active, organization). It does not create, update, or delete flows, and it does not return nodes or edges.

To execute a flow, use Runs (runActionFlow).

import { ActionFlows } from "actionflows";

const client = new ActionFlows({
  apiKey: process.env.ACTIONFLOWS_API_KEY!,
});

See Installation for install and auth.

List flowsCopy Anchor Link

const flows = await client.listActionFlows();

const orgFlows = await client.listActionFlows({
  organizationId: "org_123",
});

Each item includes id, name, organizationId, active, slug, and timestamps.

Get one flowCopy Anchor Link

const flow = await client.getActionFlow("flow_456", "org_123");
console.log(flow.name, flow.active, flow.organizationId);

organizationId is optional when the API key is already organization-scoped. A user-scoped key should pass the organization that owns the flow, the same way Get Flow and hosted MCP get_actionflow do.

AI modelsCopy Anchor Link

There is no client.generateText (or similar) method. Models run inside a flow:

1. In Actionflow Studio, add a Generate Text, Generate JSON, or Generate Image node and pick the model.
2. Call runActionFlow for that flow.
3. Read the model output from getRun.

Provider keys and cost stay on the organization. See AI Vendors and AI Model Selection Guide.

RelatedCopy Anchor Link

• Runs
• What is ActionFlow
• List Flows
• Get Flow