v1

latestOpenAPI 3.0.0Apache 2.0 License2026-07-141610169.0 KB

Creates a new execution instance of a workflow definition with specified parameters.

put/workflow-definitions/{workflowDefinitionName}/workflow-runs

Path parameters

workflowDefinitionNamestring required

The name of the workflow definition to execute.

Request body

modelIdstring required

The ID of the AI model to use for workflow execution.

clientTokenstring

A unique, case-sensitive identifier that you provide to ensure the idempotency of the request.

logGroupNamestring

The CloudWatch log group name for storing workflow execution logs.

Response

Success

workflowRunIdstring required

The unique identifier for the created workflow run.

status'RUNNING' | 'SUCCEEDED' | 'FAILED' | 'TIMED_OUT' | 'DELETING' required

The initial status of the workflow run after creation.