Post x amz targetamazonmwaaserverless.startworkflowrun

v1

latestOpenAPI 3.0.0Apache 2.0 License2026-07-14159484.0 KB

Starts a new execution of a workflow. This operation creates a workflow run that executes the tasks that are defined in the workflow. Amazon Managed Workflows for Apache Airflow Serverless schedules the workflow execution across its managed Airflow environment, automatically scaling ECS worker tasks based on the workload. The service handles task isolation, dependency resolution, and provides comprehensive monitoring and logging throughout the execution lifecycle.

post/#X-Amz-Target=AmazonMWAAServerless.StartWorkflowRun

Headers

X-Amz-Target'AmazonMWAAServerless.StartWorkflowRun' required

Request body

WorkflowArnstring required

The Amazon Resource Name (ARN) of the workflow you want to run.

ClientTokenstring

A unique, case-sensitive identifier that you provide to ensure the idempotency of the request. This token prevents duplicate workflow run requests.

OverrideParametersobject

Optional parameters to override default workflow parameters for this specific run. These parameters are passed to the workflow during execution and can be used to customize behavior without modifying the workflow definition. Parameters are made available as environment variables to tasks and you can reference them within the YAML workflow definition using standard parameter substitution syntax.

WorkflowVersionstring

Optional. The specific version of the workflow to execute. If not specified, the latest version is used.

Response

Success

RunIdstring

The unique identifier of the newly started workflow run.

The initial status of the workflow run. This is typically <code>STARTING</code> when you first create the run.

StartedAtstring date-time

The timestamp when the workflow run was started, in ISO 8601 date-time format.