# 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="/files/TZj6XRMCtbXxOSflRVXK" 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="/files/Xz2Uj95m34AYdr0T6VNf" 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="/files/b0rmMWsXFpIJ6YQDKi1h" 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="/files/XpcFGcW9N7MCuFo57Yk0" 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="/files/eAXtvunJHWC1TQNvib1l" 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="/files/8kaG8PGIAOIOqt1L4rnn" 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](/tutorials-1/flow-customization-and-operations/how-to-customize-your-authentication-flow.md)

### **Error Notification**

<figure><img src="/files/llk1TIqCvetoJeEal46u" 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](/tutorials-1/flow-customization-and-operations/how-to-customize-your-error-notification-flow.md)

## 2. Visuals

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

<figure><img src="/files/6Iis9G9WL8zYri1SLfYb" 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.


---

# Agent Instructions: 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:

```
GET https://docs.fastn.ai/flow-setup-essentials/flow-settings.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.
