# Flow Settings

When working inside any **Flow** in Fastn, you can adjust its behavior and appearance through the **Settings** option available in the **right-hand sidebar**.

<figure><img src="https://1255842839-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3iSr2Tx8FvvuoLPncziH%2Fuploads%2FIJ0YAfliEC99jBONanhE%2Fimage.png?alt=media&#x26;token=e5acd2fe-2dd7-4674-8d4c-dfb179857f99" alt="Flow editor with the Settings option highlighted in the right-hand sidebar"><figcaption></figcaption></figure>

The Settings panel has two main subsections: **Configuration** and **Visuals**.

<figure><img src="https://1255842839-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3iSr2Tx8FvvuoLPncziH%2Fuploads%2FkrBQ51gp5V3X7jCFYnnQ%2Fimage.png?alt=media&#x26;token=5f34e9cb-9b2b-497a-9daf-a3fb1fddbc57" alt="Settings panel showing Configuration and Visuals subsections"><figcaption></figcaption></figure>

## 1. Configuration

The **Configuration** section controls how your flow runs and how it handles security, validation, and errors.

### **Flow Type**

You must choose how the flow should execute:

#### **🔹 API (Real-Time Sync API)**

* Executes instantly and returns a real-time response.
* Used for synchronous tasks where the result is needed immediately.

#### **🔹 Workflow (Async Workflow Job)**

<figure><img src="https://1255842839-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3iSr2Tx8FvvuoLPncziH%2Fuploads%2FnOle6dnSfXbrtkCOgshO%2Fimage.png?alt=media&#x26;token=0b400bfe-2c1c-4010-b214-80c6acfe1fb3" alt="Workflow flow type settings with memory limit, CPU limit, priority, and timeout options"><figcaption></figcaption></figure>

* Executes in the background without blocking the request.
* Suitable for asynchronous or heavy jobs.
* When you select **Workflow**, additional options appear:
  * **Memory Limit** – Maximum memory allocation (e.g., 2 GB).
  * **CPU Limit** – Maximum processing power allocated (e.g., 1 vCPU).
  * **Priority** – Determines how quickly the workflow is executed (Low/Medium/High).
  * **Timeout (min)** – Maximum duration before the workflow stops.

When Workflow is selected, a new **Trigger** section appears in the **left sidebar**, where you can define how the workflow is initiated:

<figure><img src="https://1255842839-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3iSr2Tx8FvvuoLPncziH%2Fuploads%2FuBVpM9Hem2BpZZGLEYYz%2Fimage.png?alt=media&#x26;token=9ff41fb6-4975-4ccf-9cf9-b47a044bb5fb" alt="Trigger section in left sidebar with Manual, Event, and Schedule workflow initiation options"><figcaption></figcaption></figure>

* **Manual** – Run the workflow manually.
* **Event** – Triggered by an event.
* **Schedule** – Triggered at scheduled intervals.

### **Validation & Multi-Tenancy**

<figure><img src="https://1255842839-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3iSr2Tx8FvvuoLPncziH%2Fuploads%2FxNSjAUQfQtR87XcM3A7I%2Fimage.png?alt=media&#x26;token=ef379d63-f410-4a0d-b096-0e7000ef99c5" alt="Validation and Multi-Tenancy settings with Enable Validation and Enforce Multi-Tenancy toggles"><figcaption></figcaption></figure>

* **Enable Validation** – Enforce schema validation for flow input.
* **Enforce Multi-Tenancy** – Require the `x-fastn-space-tenantid` header to ensure the flow only accesses resources for the specified tenant.

### **Authentication**

<figure><img src="https://1255842839-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3iSr2Tx8FvvuoLPncziH%2Fuploads%2F5fINroG1WLygNMQIM6lu%2Fimage.png?alt=media&#x26;token=a589e26b-318d-4e1d-a66d-fbc8c25703f8" alt="Authentication settings with Enable Custom Authentication toggle for Authorization header support"><figcaption></figcaption></figure>

* **Enable Custom Authentication** – Allow access with an `Authorization` header instead of `x-fastn-api-key`.
* Uses the **fastnCustomAuth** flow for validation.
* You can customize this authentication flow as needed. [Learn More](https://docs.fastn.ai/flows/tutorials/flow-customization-and-operations/how-to-customize-your-authentication-flow)

### **Error Notification**

<figure><img src="https://1255842839-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3iSr2Tx8FvvuoLPncziH%2Fuploads%2FZ2bEQdakfdmSKYXTirkT%2Fimage.png?alt=media&#x26;token=c15a844d-8f24-49c2-bdb1-b1a542548c87" alt="Error Notification settings with toggle to forward errors to a notification flow like Slack"><figcaption></figcaption></figure>

* **Enable Error Notification** – Forward errors to a notification flow (e.g., sending alerts to Slack).
* You can customize this with the **fastnErrorNotification** flow. [Learn More](https://docs.fastn.ai/flows/tutorials/flow-customization-and-operations/how-to-customize-your-error-notification-flow)

## 2. Visuals

The **Visuals** section customizes the flow editor interface.

<figure><img src="https://1255842839-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3iSr2Tx8FvvuoLPncziH%2Fuploads%2FHWLggllpIKVRsvhv76M5%2Fimage.png?alt=media&#x26;token=33a310b6-46f8-4e59-8f91-50c636f07a85" alt="Visuals settings with toggles for Side Action Panel, Flow MiniMap, and Dark Mode"><figcaption></figcaption></figure>

* **Enable Side Action Panel** – Displays a quick-access panel for drag-and-drop actions.
* **Enable Flow MiniMap** – Adds a minimap to navigate large or complex flows.
* **Activate Dark Mode** – Switches the editor to dark theme.
