Sign in

v1

latestOpenAPI 3.0.0Apache 2.0 License2026-07-14108906717.7 KB

Creates an Automated Reasoning policy for Amazon Bedrock Guardrails. Automated Reasoning policies use mathematical techniques to detect hallucinations, suggest corrections, and highlight unstated assumptions in the responses of your GenAI application.

To create a policy, you upload a source document that describes the rules that you're encoding. Automated Reasoning extracts important concepts from the source document that will become variables in the policy and infers policy rules.

post/automated-reasoning-policies

Request body

namestring password required

A unique name for the Automated Reasoning policy. The name must be between 1 and 63 characters and can contain letters, numbers, hyphens, and underscores.

descriptionstring password

A description of the Automated Reasoning policy. Use this to provide context about the policy's purpose and the types of validations it performs.

clientRequestTokenstring

A unique, case-sensitive identifier to ensure that the operation completes no more than once. If this token matches a previous request, Amazon Bedrock ignores the request but doesn't return an error.

kmsKeyIdstring

The identifier of the KMS key to use for encrypting the automated reasoning policy and its associated artifacts. If you don't specify a KMS key, Amazon Bedrock uses an KMS managed key for encryption. For enhanced security and control, you can specify a customer managed KMS key.

Response

Success

policyArnstring required

The Amazon Resource Name (ARN) of the Automated Reasoning policy that you created.

versionstring required

The version number of the newly created Automated Reasoning policy. The initial version is always DRAFT.

namestring password required

The name of the Automated Reasoning policy.

descriptionstring password

The description of the Automated Reasoning policy.

definitionHashstring

The hash of the policy definition. This is used as a concurrency token for creating policy versions that you can use in your application.

createdAtstring date-time required

The timestamp when the policy was created.

updatedAtstring date-time required

The timestamp when the policy was last updated.