> ## Documentation Index
> Fetch the complete documentation index at: https://auth0-docs-event-stream-action-templates.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

> Describes how to review Flow executions and debug executions of Forms.

# Execution and Debugger

Each time a flow executes, Auth0 stores an entry that you can use to debug the execution. This is useful to understand why a flow execution error has occurred. For example: a flow can fail due to missing properties, typos, incorrect API keys, etc.

## Review flow executions

To review an execution entry for a flow, follow the steps below:

1. Navigate to **Auth0 Dashboard > Actions > Forms**, then select **Flows**.
2. Select a flow from the list.
3. Select **Executions**.

<Frame>
  <img src="https://mintlify.s3.us-west-1.amazonaws.com/auth0-docs-event-stream-action-templates/docs/images/cdy7uua7fh8z/448jfjHtgCxfIeDOakuHyd/fba64deda0cf920f399de2190e94bdc9/Flows-execution.png" alt="Dashboard > Actions > Forms > Flows > Execution" />
</Frame>

Every execution entry has four properties:

* **Execution date**: The date of the flow execution.
* **Execution ID**: The unique ID of the flow execution.
* **Status**: The current stage of the flow execution. There are four possible execution statuses:

  * **Running**: The execution is currently in progress.
  * **Failed**: The execution failed due to an internal error, such as missing required settings in a flow action.
  * **Completed**: The execution finished without internal errors.
* **View Details**: Opens the debug window of the execution.

<Frame>
  <img src="https://mintlify.s3.us-west-1.amazonaws.com/auth0-docs-event-stream-action-templates/docs/images/cdy7uua7fh8z/1VqWEaVZg5lrXatXe9dbFB/dbcf7edca5aabdfc544f04cb18be4149/Flow-execution-details.png" alt="Dashboard > Actions >  Forms > Flows > Executions" />
</Frame>

<Callout icon="file-lines" color="#0EA5E9" iconType="regular">
  Completed and Failed are final statuses. When an execution reaches either status, the flow is fully processed.
</Callout>

## Debug flow executions

To help debug or troubleshoot a flow, you can review the flow’s input, output, and error data by accessing the **View Details** of the execution.

<Frame>
  <img src="https://mintlify.s3.us-west-1.amazonaws.com/auth0-docs-event-stream-action-templates/docs/images/cdy7uua7fh8z/5aeniTfHXplDyZfwCKBcgK/a2098a476edde76da10a527b0a606e95/Flow-error.png" alt="Dashboard > Actions > Forms > Form" />
</Frame>

To debug an error that interrupts the flow execution, follow these steps:

1. Navigate to **Auth0 Dashboard > Actions > Forms**
2. Locate the flow linked to the step node.

   <Frame>
     <img src="https://mintlify.s3.us-west-1.amazonaws.com/auth0-docs-event-stream-action-templates/docs/images/cdy7uua7fh8z/4LjULYyo0nhtNowm7J5okz/27ea3f8386bb5015d447c48facf6b90f/flow-error-linked.png" alt="Dashboard > Actions > Forms > Form" />
   </Frame>
3. Select **Edit Flow.**
4. Select **Executions**.
5. Select **View Details** of the Failed execution.

In the example below, the `Update user` **Input** view shows a null value for the  `user_id` property.

<Frame>
  <img src="https://mintlify.s3.us-west-1.amazonaws.com/auth0-docs-event-stream-action-templates/docs/images/cdy7uua7fh8z/6QNYKDqG9AIOEzQkP6Fnnr/db885e146179a0490eddd5ad6cb518dc/Flow-execution-failed.png" alt="Dashboard > Actions > Forms > Flow > Execution" />
</Frame>

The **Error** view indicates that the action’s schema validation failed due to a missing the required `user_id`. The flow returns an internal error that interrupts the flow execution.

<Frame>
  <img src="https://mintlify.s3.us-west-1.amazonaws.com/auth0-docs-event-stream-action-templates/docs/images/cdy7uua7fh8z/1kaKihtJtv8VvNAyTkW4cC/6b34bcecc8642d7d97aaf2c8dec51ebc/flow-execution-error-view.png" alt="Dashboard > Actions > Forms > Flow > Execution > Error" />
</Frame>

A review of the **Update user** action shows a syntax error in the `User ID` parameter, the correct syntax is `{{context.user.user_id}}`. Once the syntax is corrected, test the flow to confirm. To learn more about variable syntaxes, read [Variables](/docs/customize/forms/variables).

<Frame>
  <img src="https://mintlify.s3.us-west-1.amazonaws.com/auth0-docs-event-stream-action-templates/docs/images/cdy7uua7fh8z/4YLRVNbzK5LjJEQjFXIJXM/5003833784ce5b0d9f63730ed46ff047/Action-typo-error.png" alt="Dashboard > Actions > Forms > Flows" />
</Frame>

<Callout icon="file-lines" color="#0EA5E9" iconType="regular">
  If a field is configured as transient or when its value is masked with a [Helper function](/docs/customize/forms/variables#helper-functions), the value is not available to debug.

  <Frame>
    <img src="https://mintlify.s3.us-west-1.amazonaws.com/auth0-docs-event-stream-action-templates/docs/images/cdy7uua7fh8z/4MVtjnVD50cG63ocN5a458/c0337a94d1f4c21f28d06e28ec59121e/masked-information.png" alt="Dashboard > Actions > Forms > Flows > Execution" />
  </Frame>
</Callout>
