Select your cookie preferences

We use essential cookies and similar tools that are necessary to provide our site and services. We use performance cookies to collect anonymous statistics, so we can understand how customers use our site and make improvements. Essential cookies cannot be deactivated, but you can choose “Customize” or “Decline” to decline performance cookies.

If you agree, AWS and approved third parties will also use cookies to provide useful site features, remember your preferences, and display relevant content, including relevant advertising. To accept or decline all non-essential cookies, choose “Accept” or “Decline.” To make more detailed choices, choose “Customize.”

Preferences
Contact Us
Feedback
AWS Documentation
Create an AWS Account

Create a version of a guardrail

PDF
RSS
Focus mode
Create a version of a guardrail - Amazon Bedrock

To create a version of a guardrail, choose the tab for your preferred method, and then follow the steps:

Console
To create a version of an existing guardrail follow these steps:

  1. Sign in to the AWS Management Console using an IAM role with Amazon Bedrock permissions, and open the Amazon Bedrock console at https://console.aws.amazon.com/bedrock/.

  2. Select Guardrails from the left navigation pane in the Amazon Bedrock console and choose the name of the guardrail that you want to edit in the Guardrails section.

  3. Carry out one of the following steps.

    • In the Versions, section, select Create.

    • Choose the Working draft and select Create version at the top of the page

  4. Provide an optional description for the version and then select Create version.

  5. If successful, you will be redirected to the screen with a list of versions with your new version added there.

API

To create a version of your guardrail, send a CreateGuardrailVersion request. Include the guardrail ID and an optional description.

The request format is as follows:

POST /guardrails/guardrailIdentifier HTTP/1.1
Content-type: application/json


{
  "clientRequestToken": "string",
  "description": "string"
}

The response format is as follows:

HTTP/1.1 202
Content-type: application/json

{
   "guardrailId": "string",
   "version": "string"
}
anchoranchor
To create a version of an existing guardrail follow these steps:

  1. Sign in to the AWS Management Console using an IAM role with Amazon Bedrock permissions, and open the Amazon Bedrock console at https://console.aws.amazon.com/bedrock/.

  2. Select Guardrails from the left navigation pane in the Amazon Bedrock console and choose the name of the guardrail that you want to edit in the Guardrails section.

  3. Carry out one of the following steps.

    • In the Versions, section, select Create.

    • Choose the Working draft and select Create version at the top of the page

  4. Provide an optional description for the version and then select Create version.

  5. If successful, you will be redirected to the screen with a list of versions with your new version added there.

Related resources

Amazon Bedrock API Reference
AWS CLI commands for Amazon Bedrock
SDKs & Tools 

Related resources

Amazon Bedrock API Reference
AWS CLI commands for Amazon Bedrock
SDKs & Tools 
PrivacySite termsCookie preferences
© 2025, Amazon Web Services, Inc. or its affiliates. All rights reserved.