# CreateAIGuardrailVersion Creates an Amazon Q in Connect AI Guardrail version. ## Request Syntax ``` POST /assistants/assistantId/aiguardrails/aiGuardrailId/versions HTTP/1.1 Content-type: application/json { "clientToken": "string", "modifiedTime": number } ``` ## URI Request Parameters The request uses the following URI parameters. ** [aiGuardrailId](#API_amazon-q-connect_CreateAIGuardrailVersion_RequestSyntax) ** The identifier of the Amazon Q in Connect AI Guardrail. Pattern: `[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}(:[A-Z0-9_$]+){0,1}$|^arn:[a-z-]*?:wisdom:[a-z0-9-]*?:[0-9]{12}:[a-z-]*?/[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}(?:/[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}){0,2}(:[A-Z0-9_$]+){0,1}` Required: Yes ** [assistantId](#API_amazon-q-connect_CreateAIGuardrailVersion_RequestSyntax) ** The identifier of the Amazon Q in Connect assistant. Can be either the ID or the ARN. URLs cannot contain the ARN. Pattern: `[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}$|^arn:[a-z-]*?:wisdom:[a-z0-9-]*?:[0-9]{12}:[a-z-]*?/[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}(?:/[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}){0,2}` Required: Yes ## Request Body The request accepts the following data in JSON format. ** [clientToken](#API_amazon-q-connect_CreateAIGuardrailVersion_RequestSyntax) ** A unique, case-sensitive identifier that you provide to ensure the idempotency of the request. If not provided, the AWS SDK populates this field. For more information about idempotency, see [Making retries safe with idempotent APIs](http://aws.amazon.com/builders-library/making-retries-safe-with-idempotent-APIs/).. Type: String Length Constraints: Minimum length of 1. Maximum length of 4096. Required: No ** [modifiedTime](#API_amazon-q-connect_CreateAIGuardrailVersion_RequestSyntax) ** The time the AI Guardrail was last modified. Type: Timestamp Required: No ## Response Syntax ``` HTTP/1.1 200 Content-type: application/json { "aiGuardrail": { "aiGuardrailArn": "string", "aiGuardrailId": "string", "assistantArn": "string", "assistantId": "string", "blockedInputMessaging": "string", "blockedOutputsMessaging": "string", "contentPolicyConfig": { "filtersConfig": [ { "inputStrength": "string", "outputStrength": "string", "type": "string" } ] }, "contextualGroundingPolicyConfig": { "filtersConfig": [ { "threshold": number, "type": "string" } ] }, "description": "string", "modifiedTime": number, "name": "string", "sensitiveInformationPolicyConfig": { "piiEntitiesConfig": [ { "action": "string", "type": "string" } ], "regexesConfig": [ { "action": "string", "description": "string", "name": "string", "pattern": "string" } ] }, "status": "string", "tags": { "string" : "string" }, "topicPolicyConfig": { "topicsConfig": [ { "definition": "string", "examples": [ "string" ], "name": "string", "type": "string" } ] }, "visibilityStatus": "string", "wordPolicyConfig": { "managedWordListsConfig": [ { "type": "string" } ], "wordsConfig": [ { "text": "string" } ] } }, "versionNumber": number } ``` ## Response Elements If the action is successful, the service sends back an HTTP 200 response. The following data is returned in JSON format by the service. ** [aiGuardrail](#API_amazon-q-connect_CreateAIGuardrailVersion_ResponseSyntax) ** The data of the AI Guardrail version. Type: [AIGuardrailData](API_amazon-q-connect_AIGuardrailData.md) object ** [versionNumber](#API_amazon-q-connect_CreateAIGuardrailVersion_ResponseSyntax) ** The version number of the AI Guardrail version. Type: Long Valid Range: Minimum value of 1. ## Errors For information about the errors that are common to all actions, see [Common Errors](CommonErrors.md). ** AccessDeniedException ** You do not have sufficient access to perform this action. HTTP Status Code: 403 ** ConflictException ** The request could not be processed because of conflict in the current state of the resource. For example, if you're using a `Create` API (such as `CreateAssistant`) that accepts name, a conflicting resource (usually with the same name) is being created or mutated. HTTP Status Code: 409 ** ResourceNotFoundException ** The specified resource does not exist. ** resourceName ** The specified resource name. HTTP Status Code: 404 ** ServiceQuotaExceededException ** You've exceeded your service quota. To perform the requested action, remove some of the relevant resources, or use service quotas to request a service quota increase. HTTP Status Code: 402 ** ThrottlingException ** The throttling limit has been exceeded. HTTP Status Code: 429 ** UnauthorizedException ** You do not have permission to perform this action. HTTP Status Code: 401 ** ValidationException ** The input fails to satisfy the constraints specified by a service. HTTP Status Code: 400 ## See Also For more information about using this API in one of the language-specific AWS SDKs, see the following: + [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/qconnect-2020-10-19/CreateAIGuardrailVersion) + [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/qconnect-2020-10-19/CreateAIGuardrailVersion) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/qconnect-2020-10-19/CreateAIGuardrailVersion) + [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/qconnect-2020-10-19/CreateAIGuardrailVersion) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/qconnect-2020-10-19/CreateAIGuardrailVersion) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/qconnect-2020-10-19/CreateAIGuardrailVersion) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/qconnect-2020-10-19/CreateAIGuardrailVersion) + [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/qconnect-2020-10-19/CreateAIGuardrailVersion) + [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/qconnect-2020-10-19/CreateAIGuardrailVersion) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/qconnect-2020-10-19/CreateAIGuardrailVersion)