Portal

The Portal is the Swirls web application where you design workflows, manage resources, and monitor executions.

What you manage in the Portal

Projects

Create and switch between projects. Every resource (graphs, forms, triggers, schemas, streams, secrets, agents) is scoped to a single project. Organizations can share projects across team members.

Builder

The Builder is the central workspace for designing workflows. From the Builder you can:

• Graphs — Create and edit DAGs with the visual node editor. Add nodes, connect them with edges, and configure triggers on root nodes. Run graphs manually or through triggers.
• Forms — Define form schemas for structured input. Forms feed into form triggers and can be embedded in your app via the SDK.
• Agents — Configure AI agents with prompts and attach graphs as tools that the agent can call during a conversation.
• Schemas — Define reusable JSON Schema objects for validation and code generation.
• Webhooks — Create webhook endpoints that external systems can POST to.
• Schedules — Set up cron-based recurring triggers with timezone support.

Portal (user-facing)

The Portal tab exposes forms to end users. It lists available forms, displays submission interfaces, and shows project metrics (graph count, trigger count, form count).

Inbox

The Inbox is a human-in-the-loop review queue. When a graph contains review nodes, execution pauses and creates a review item in the Inbox. Reviewers can approve or reject items with structured feedback, and execution resumes based on the outcome.

Storage

Manage data persistence for your project:

• Streams — View and query graph output data with column selection and pagination.
• Secrets — Store and manage encrypted API keys and tokens that nodes can access at runtime.
• Buckets — Upload, download, and manage files with signed URLs.

Executions

View graph and node execution history with payload, status, timestamps, and per-node input/output. Use execution details to debug runs and monitor workflow performance.

Where to go next

• CLI — Authenticate, manage projects, and generate TypeScript types from the command line.
• SDK / Code Gen — Embed forms and run graphs from your React app with the headless SDK.
• API — Manage resources and execute graphs programmatically.

Everything available in the Portal is also accessible through the API and SDK, so you can automate and embed workflows in your own product.