---
title: "POST /flows/{flowIdentifier}/aliases/{flowAliasIdentifier}/executions"
method: POST
path: "/flows/{flowIdentifier}/aliases/{flowAliasIdentifier}/executions"
---

# POST /flows/{flowIdentifier}/aliases/{flowAliasIdentifier}/executions

`POST /flows/{flowIdentifier}/aliases/{flowAliasIdentifier}/executions`

Starts an execution of an Amazon Bedrock flow. Unlike flows that run until completion or time out after five minutes, flow executions let you run flows asynchronously for longer durations. Flow executions also yield control so that your application can perform other tasks.

This operation returns an Amazon Resource Name (ARN) that you can use to track and manage your flow execution.

Flow executions is in preview release for Amazon Bedrock and is subject to change.

## Path parameters

- `flowAliasIdentifier` string, required
- `flowIdentifier` string, required

## Request body

- object
  - `flowExecutionName` string — The unique name for the flow execution. If you don't provide one, a system-generated name is used.
  - `inputs` FlowInput[], required — The input data required for the flow execution. This must match the input schema defined in the flow.
    - `content` object, required — Contains information about an input into the prompt flow.
      - `document` object — The input to send to the prompt flow input node.
    - `nodeInputName` string — The name of the input from the flow input node.
    - `nodeName` string, required — The name of the flow input node that begins the prompt flow.
    - `nodeOutputName` string — The name of the output from the flow input node that begins the prompt flow.
  - `modelPerformanceConfiguration` object — The performance configuration for a model called with <a>InvokeFlow</a>.
    - `performanceConfig` object — The latency configuration for the model.
      - `latency` 'standard' | 'optimized' — To use a latency-optimized version of the model, set to <code>optimized</code>.

## Response `200`

Success

- StartFlowExecutionResponse
  - `executionArn` string — The Amazon Resource Name (ARN) that uniquely identifies the flow execution.

## Other responses

- `480` — ResourceNotFoundException
- `481` — ConflictException
- `482` — ValidationException
- `483` — InternalServerException
- `484` — DependencyFailedException
- `485` — BadGatewayException
- `486` — ThrottlingException
- `487` — AccessDeniedException
- `488` — ServiceQuotaExceededException

---

[API](https://skmtc.net/aws/apis/bedrock-agent-runtime.md) · [All operations](https://skmtc.net/aws/apis/bedrock-agent-runtime/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/aws/bedrock-agent-runtime/versions/fe358131c0ad/schema)