Conigma Connect

Interactive Flows

What are Interactive Flows?

Interactive Flows let everyday users run flows without ever opening the Flow Editor. Instead of navigating a technical interface, users get a simple form where they fill in the required information and click Start.

As a Flow Developer, you decide which of your flows should be available this way, what data users need to provide, and whether flows can be triggered via a shareable link.

As a Flow User, you simply pick a flow from a list, fill in a form (if needed), and watch it run.

For Flow Users

Finding and running a flow

  1. Open the sidebar and go to Flows → Interactive Flows.

  2. You'll see a list of all flows that have been made available to you. Each row shows the flow's name, its location, and any tags.

  3. Click the Launch button next to the flow you want to run.

Filling in the form

After clicking Launch, one of two things happens:

  • The flow needs information from you: A form appears with fields for the data the flow requires — for example a customer name, a number of items, or a yes/no choice. Fill in the fields and click Start Flow.

  • The flow needs no information: You'll see a message saying "This flow requires no input data". Just click Start Flow.

Watching the flow run

After you start a flow, you're taken to the Run page. Here you can see:

  • A live status indicator — a spinning ring while the flow is running, a green checkmark when it succeeds, or a red icon if something goes wrong.

  • Elapsed time — a timer showing how long the flow has been running.

  • A status message — a plain-language explanation like "The flow is currently running..." or "The flow completed successfully."

Once the flow finishes, two buttons appear:

Button

What it does

Rerun

Starts the same flow again with the same inputs you used before.

New Inputs

Takes you back to the form so you can change the data and run again.

If the flow produces an HTML result (for example, a report or a summary page), it is displayed directly below the status card.

Using a shared link

Someone might send you a direct link to a flow — for example via email or chat. These links can work in two ways:

  • The link opens a pre-filled form. Some or all of the fields are already filled in based on the link. You can review the values, change anything you need, and click Start Flow.

  • The link starts the flow immediately. If the link includes start_flow=true and the flow developer has enabled this, the flow runs as soon as you open the link. You'll go straight to the Run page.

If the link tries to auto-start but some required data is missing, you'll see the form instead with whatever data was in the link already filled in.

Sharing a link yourself

If the flow developer has enabled link sharing, you'll see a Copy Link button next to Start Flow. Clicking it copies a link that includes all the data you've entered in the form. Anyone who opens that link will see the form pre-filled with your data (or the flow will start automatically, depending on the configuration).

For Flow Developers

Making a flow interactive

You can turn any existing flow into an interactive flow through the Flow Settings dialog.

  1. Open your flow in the Flow Editor.

  2. Open the Flow Settings dialog (the gear/settings button).

  3. Switch to the Interactive tab.

  4. Turn on Enable Interactive Mode.

That's it — your flow will now appear in the Interactive Flows list for users.

Tip: The Save button is disabled if the schema contains syntax errors, so you can't accidentally save an invalid configuration.

Defining what data users need to provide

If your flow requires input data, you define it using a JSON Schema in the Input Schema editor on the Interactive tab.

The schema determines what form fields users see. For example, the following schema creates a form with a text field and a number field:

Rendering...

How schema types map to form fields:

Schema type

Form field shown to the user

string

Text input

integer

Number input (whole numbers)

number

Number input (decimals allowed)

boolean

Checkbox / toggle

array

Multiple-value input

object

Nested group of fields

If your flow doesn't need any input, you can leave the schema as the default (true) — users will simply see a "Start Flow" button with no form.

Configuring how the flow can be started

Under Allowed Triggers, you can enable:

Trigger

What it means

Link Click

When checked, users (or external systems) can start the flow by opening a URL with start_flow=true in the query string. A "Copy Link" button also becomes available on the launch page so users can share pre-filled links.

If Link Click is not checked, the flow can only be started by clicking the Start Flow button on the launch page. Links will still work for pre-filling the form, but won't auto-start.

Disabling interactive mode

To remove a flow from the Interactive Flows list, simply go back to the Interactive tab in Flow Settings and turn off Enable Interactive Mode. The flow continues to work normally in the Flow Editor — it just won't be visible to users in the Interactive Flows list anymore.

URL Reference

These are the URLs used by Interactive Flows. They can be useful for bookmarking, sharing, or integrating with external systems.

Page

URL

Notes

All interactive flows

/flows/interactive

The browsable list of all interactive flows

Launch a specific flow

/flows/interactive/{flowId}

Shows the form (or start button) for a flow

Launch with pre-filled data

/flows/interactive/{flowId}?field1=value1&field2=value2

Pre-fills form fields from the URL

Launch and auto-start

/flows/interactive/{flowId}?field1=value1&start_flow=true

Starts immediately if Link Click is enabled

View a flow run

/flows/interactive/{flowId}/runs/{runId}

The live execution status page

Query parameter type handling:

When data is passed via URL query parameters, values are automatically converted based on the flow's input schema:

Schema type

Example URL parameter

Interpreted as

string

?name=Alice

Text: "Alice"

integer

?count=42

Number: 42

number

?price=19.99

Number: 19.99

boolean

?active=true

Boolean: true

array

?tags=red,green,blue

List: ["red", "green", "blue"]

Frequently Asked Questions

Can unauthenticated users run interactive flows? The current implementation requires users to be authenticated and to have the Flow Run scope.

What happens if I change the input schema after users have already run the flow? Previous runs are not affected. The new schema applies to all future runs. If someone opens an old shared link, fields that no longer exist in the schema are ignored, and any new required fields will appear empty on the form.

Can I see past executions of my interactive flow? Yes — past executions are visible through the existing Run page accessible through the URL. A dedicated past runs view per interactive flow is planned for a future release.

Does the flow input data get validated? Yes. When a user clicks Start Flow, the input data is validated against the JSON Schema before the flow starts. If validation fails, an error message is shown and the flow does not start.

Can I use Interactive Flows with scheduled flows? Yes. Scheduling and interactive mode are independent settings. A flow can be both scheduled (runs automatically on a timer) and interactive (can also be started manually by users).