---
title: "POST /guardrails/{guardrailIdentifier}"
method: POST
path: "/guardrails/{guardrailIdentifier}"
---

# POST /guardrails/{guardrailIdentifier}

`POST /guardrails/{guardrailIdentifier}`

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.

## Path parameters

- `guardrailIdentifier` string, required

## Request body

- object
  - `description` string, password — A description of the guardrail version.
  - `clientRequestToken` string — 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 `202`

Success

- CreateGuardrailVersionResponse
  - `guardrailId` string, required — The unique identifier of the guardrail.
  - `version` string, required — The number of the version of the guardrail.

## Other responses

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

---

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