v1

latestOpenAPI 3.0.0Apache 2.0 License2026-07-14108906717.7 KB

Creates a version of the guardrail. Use this API to create a snapshot of the guardrail when you are satisfied with a configuration, or to compare the configuration with another version.

post/guardrails/{guardrailIdentifier}

Path parameters

guardrailIdentifierstring required

The unique identifier of the guardrail. This can be an ID or the ARN.

Request body

descriptionstring password

A description of the guardrail version.

clientRequestTokenstring

A unique, case-sensitive identifier to ensure that the API request completes no more than once. 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> in the <i>Amazon S3 User Guide</i>.

Response

Success

guardrailIdstring required

The unique identifier of the guardrail.

versionstring required

The number of the version of the guardrail.