Sign in

v1

latestOpenAPI 3.0.0Apache 2.0 License2026-07-1475719557.8 KB

Creates a version of the flow that you can deploy. 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.

post/flows/{flowIdentifier}/versions

Path parameters

flowIdentifierstring required

The unique identifier of the flow that you want to create a version of.

Request body

descriptionstring

A description of the version of the flow.

clientTokenstring

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>.

Response

Success

namestring required

The name of the version.

descriptionstring

The description of the version.

executionRoleArnstring required

The Amazon Resource Name (ARN) of the service role with permissions to create a flow. For more information, see <a href="https://docs.aws.amazon.com/bedrock/latest/userguide/flows-permissions.html">Create a service role for flows in Amazon Bedrock</a> in the Amazon Bedrock User Guide.

customerEncryptionKeyArnstring

The KMS key that the flow is encrypted with.

idstring required

The unique identifier of the flow.

arnstring required

The Amazon Resource Name (ARN) of the flow.

status'Failed' | 'Prepared' | 'Preparing' | 'NotPrepared' required

The status of the flow.

createdAtstring date-time required

The time at which the flow was created.

versionstring required

The version of the flow that was created. Versions are numbered incrementally, starting from 1.