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

# POST /flows/{flowIdentifier}/aliases

`POST /flows/{flowIdentifier}/aliases`

Creates an alias of a flow for deployment. For more information, see <a href="https://docs.aws.amazon.com/bedrock/latest/userguide/flows-deploy.html">Deploy a flow in Amazon Bedrock</a> in the Amazon Bedrock User Guide.

## Path parameters

- `flowIdentifier` string, required

## Request body

- object
  - `name` string, required — A name for the alias.
  - `description` string — A description for the alias.
  - `routingConfiguration` FlowAliasRoutingConfigurationListItem[], required — Contains information about the version to which to map the alias.
    - `flowVersion` string — The version that the alias maps to.
  - `concurrencyConfiguration` object — Determines how multiple nodes in a flow can run in parallel. Running nodes concurrently can improve your flow's performance.
    - `type` 'Automatic' | 'Manual' — <p>The type of concurrency to use for parallel node execution. Specify one of the following options:</p> <ul> <li> <p> <code>Automatic</code> - Amazon Bedrock determines which nodes can be executed in parallel based on the flow definition and its dependencies.</p> </li> <li> <p> <code>Manual</code> - You specify which nodes can be executed in parallel.</p> </li> </ul>
    - `maxConcurrency` integer — The maximum number of nodes that can be executed concurrently in the flow.
  - `clientToken` string — A unique, case-sensitive identifier to ensure that the API request completes no more than one time. If this token matches a previous request, Amazon Bedrock ignores the request, but does not return an error. For more information, see <a href="https://docs.aws.amazon.com/AWSEC2/latest/APIReference/Run_Instance_Idempotency.html">Ensuring idempotency</a>.
  - `tags` object — Any tags that you want to attach to the alias of the flow. For more information, see <a href="https://docs.aws.amazon.com/bedrock/latest/userguide/tagging.html">Tagging resources in Amazon Bedrock</a>.

## Response `201`

Success

- CreateFlowAliasResponse
  - `name` string, required — The name of the alias.
  - `description` string — The description of the alias.
  - `routingConfiguration` FlowAliasRoutingConfigurationListItem[], required — Contains information about the version that the alias is mapped to.
    - `flowVersion` string — The version that the alias maps to.
  - `concurrencyConfiguration` object — The configuration that specifies how nodes in the flow are executed in parallel.
    - `type` 'Automatic' | 'Manual', required — <p>The type of concurrency to use for parallel node execution. Specify one of the following options:</p> <ul> <li> <p> <code>Automatic</code> - Amazon Bedrock determines which nodes can be executed in parallel based on the flow definition and its dependencies.</p> </li> <li> <p> <code>Manual</code> - You specify which nodes can be executed in parallel.</p> </li> </ul>
    - `maxConcurrency` integer — The maximum number of nodes that can be executed concurrently in the flow.
  - `flowId` string, required — The unique identifier of the flow that the alias belongs to.
  - `id` string, required — The unique identifier of the alias.
  - `arn` string, required — The Amazon Resource Name (ARN) of the alias.
  - `createdAt` string, date-time, required — The time at which the alias was created.
  - `updatedAt` string, date-time, required — The time at which the alias of the flow was last updated.

## Other responses

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

---

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