> For the complete documentation index, see [llms.txt](https://help.tillit.cloud/tillit/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.tillit.cloud/tillit/knowledge-base/setting-up-tillit/integrations/wire-flow/introduction-and-concepts.md).

# Introduction & Concepts

Wire Flow is a **middleware tool** that lets integration engineers build data transformation and orchestration pipelines visually — connecting systems, parsing file formats, calling APIs, and routing data, all without managing servers or writing code.

**Common use cases:**

* Parse incoming CSV or Excel files and send the data to an external API
* Receive an MQTT message from a device and trigger a downstream workflow
* Transform XML orders to JSON, validate them, and route them conditionally
* Invoke an AI model to classify incoming data, then send an email based on the result

## Core Concepts

| Term         | What it means                                                                                   |
| ------------ | ----------------------------------------------------------------------------------------------- |
| **BPMN**     | A standard diagram notation for workflows. Nodes = tasks, arrows = flow between them            |
| **Workflow** | A sequence of connected tasks that runs automatically when triggered                            |
| **Tenant**   | Your isolated environment. All workflows, credentials, and executions are scoped to your tenant |

## EXPRESS vs STANDARD Workflows

When creating a workflow, choose a type based on how long it runs and how it returns results.

|                       | EXPRESS                                            | STANDARD                                               |
| --------------------- | -------------------------------------------------- | ------------------------------------------------------ |
| **Max duration**      | 5 minutes                                          | Up to 1 year                                           |
| **Execution**         | Synchronous — waits and returns output immediately | Asynchronous — starts and completes in the background  |
| **Execution history** | Available via the Executions view                  | Full history available                                 |
| **Pricing**           | Per execution + duration                           | Per step transition                                    |
| **Best for**          | API transforms, short ETL, file processing         | Long-running processes, human approvals, waiting tasks |

{% hint style="info" %}
Most integration workflows should use **EXPRESS**. If a single message is taking longer than 5 minutes, that is a signal something is wrong upstream.
{% endhint %}

**A note on EXPRESS reliability:** In rare failure scenarios, AWS may re-invoke an EXPRESS workflow. Design your workflows to be safe to run twice — for example, use update-or-create operations rather than blind inserts when writing to external systems.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://help.tillit.cloud/tillit/knowledge-base/setting-up-tillit/integrations/wire-flow/introduction-and-concepts.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
