Schema
WaitForReplyStepDefinition
Wait-for-reply step — pauses until an inbound email matches the thread. Monitors the Agentmail inbox for a reply to a previously sent email. The workflow pauses (WAIT) and resumes when a matching reply is detected or the timeout expires.
| Field | Type | Description |
|---|---|---|
idrequired | string | — |
namerequired | string | — |
type | string | — |
description | string | null | — |
depends_on | string | object[] | — |
stage | string | null | — |
timeout | string | Max time to wait for a reply before timing out |
retry_policy | RetryPolicy | null | — |
error_handler | StepErrorHandler | null | — |
impact_level | "low" | "medium" | "high" | "critical" | Impact classification for steps.lowmediumhighcritical |
run_mode | "propose" | "auto_run" | Execution mode for steps.proposeauto_run |
requires_approval | boolean | — |
metadata | object | null | — |
examples | StepExample[] | null | Attached example files for this step. Each entry pairs a platform.file_uploads.file_id with a role + tags + notes so the runtime can shape its instruction. Bounded at 20 to keep a reasonable upper limit on the prompt preamble. |
tags | string[] | null | Categorical labels on the step itself (e.g. 'pdf-read', 'coutts', 'fy25'). Free-form; recommended tag set is documented per workstream surface. |
sent_message_id_fromrequired | string | Context path to the message_id of the sent email to watch for replies |
on_reply | string | null | Step ID to jump to when reply is received (default: next step) |
on_timeout | string | null | Step ID to jump to on timeout (default: next step with timeout status) |