# User Input

Action `person.bubble`

`action.user_input`

Show a native macOS dialog to collect input from the user mid-workflow. Supports text fields, file pickers, directory pickers, and choice buttons. The response is cached according to the configured cache mode so users are not repeatedly prompted.

This node pauses execution until the user responds. If the dialog is dismissed, the workflow stops.

## Ports

Direction | Name | Data Type | Description
--- | --- | --- | ---
Input | Input | Any | Incoming payload
Output | Output | Any | Payload with user response

## Configuration

Field | Type | Default | Description
--- | --- | --- | ---
title | Text | — | Dialog window title
message | Text | — | Prompt message shown to the user
inputType | Dropdown | `text` | Input type: Text Field, Directory Picker, File Picker, or Choice Buttons
defaultValue | Text | — | Pre-filled value for the text field. Visible when inputType = text.
choices | Text Area | — | One choice per line. Visible when inputType = choice.
cacheMode | Dropdown | `session` | Cache: Remember for Session, Always Ask, or Remember Forever

## Output Variables

Variable | Type | Description
--- | --- | ---
userInput | String | The value entered or selected by the user

## Example

Prompt the user for an API key before making a scheduled request: