Skip to main content

MONITOR_CONFIRM

Display a confirmation dialog in the Flow Monitor. Pauses workflow until user responds.

At a glance

  • Category UI
  • Version: 1.2.0
  • Applications: all
  • Scope: all

When to Use

Use MONITOR_CONFIRM when you need Yes/No confirmation before proceeding.

Use MONITOR_CONFIRM for:

  • Confirming destructive operations (delete, publish, overwrite)
  • Approval of AI-generated content
  • Simple Yes/No decisions
  • Checkpoint confirmations in workflows

Don't use MONITOR_CONFIRM when:

  • You need multiple choice options → use MONITOR_CHOICE
  • You only need to show status → use MONITOR_STATUS
  • You need text input → use MONITOR_INPUT
  • You just need "Continue" button → use MONITOR_STATUS with appropriate message

Config Options

NameDescriptionDefaultRequiredResolvedConstraintsConditional Rules
messageThe confirmation message to display. Supports variable resolution with {{variable}}.NonetruetrueNoneNone
contentOptional rich content to display (e.g., AI-generated text for review). Supports markdown.NonefalsetrueNoneNone
confirmLabel for the confirm button (default: "Confirm"). Used in Yes/No mode.ConfirmfalsefalseNoneNone
cancelLabel for the cancel button (default: "Cancel"). Used in Yes/No mode.CancelfalsefalseNoneNone
confirmTypeVisual style of the confirm button.primaryfalsefalseNoneNone
timeoutOptional timeout in seconds. Auto-cancels if user does not respond.NonefalsefalseNoneNone

Outputs

TypeDescriptionOptional
booleantrue if confirmed, false if cancelled. Default output: flowContext.confirmedfalse

Examples

Simple confirmation (default output)

- step: MONITOR_CONFIRM
message: "Publish this article?"

- step: IF
condition: "{{flowContext.confirmed}}"
then:
- step: PUBLISH_ARTICLE

Confirmation with custom labels

- step: MONITOR_CONFIRM
message: "Publish this article?"
confirm: "Yes, Publish"
cancel: "Cancel"
confirmType: danger

- step: IF
condition: "{{flowContext.confirmed}}"
then:
- step: ... # publish

Custom output name

- step: MONITOR_CONFIRM
message: "Delete all drafts?"
confirm: "Delete"
cancel: "Keep"
confirmType: danger
outputs:
- type: boolean
name: shouldDelete

- step: IF
condition: "{{flowContext.shouldDelete}}"
then:
- step: ...

AI content approval with preview

- step: MONITOR_CONFIRM
message: "Review the AI response:"
content: "{{flowContext.aiGeneratedText}}"
confirm: "Approve"
cancel: "Reject"
confirmType: success

- step: IF
condition: "{{confirmed}}"
then:
- step: INSERT_TEXT
# ...
else:
- step: SHOW_NOTIFICATION
message: "AI response rejected"

Confirmation with timeout

- step: MONITOR_CONFIRM
message: "Approve changes?"
timeout: 30
outputs:
- type: boolean
name: approved

- step: IF
condition: "{{flowContext.approved}}"
then:
- step: ...
else:
- step: SHOW_NOTIFICATION
message: "Timed out or cancelled"

See Also

General Resources: