Sign in

v1

latestOpenAPI 3.0.0Apache 2.0 License2026-07-1475719557.8 KB

Creates a prompt in your prompt library that you can add to a flow. For more information, see <a href="https://docs.aws.amazon.com/bedrock/latest/userguide/prompt-management.html">Prompt management in Amazon Bedrock</a>, <a href="https://docs.aws.amazon.com/bedrock/latest/userguide/prompt-management-create.html">Create a prompt using Prompt management</a> and <a href="https://docs.aws.amazon.com/bedrock/latest/userguide/flows.html">Prompt flows in Amazon Bedrock</a> in the Amazon Bedrock User Guide.

post/prompts/

Request body

namestring required

A name for the prompt.

descriptionstring

A description for the prompt.

customerEncryptionKeyArnstring

The Amazon Resource Name (ARN) of the KMS key to encrypt the prompt.

defaultVariantstring

The name of the default variant for the prompt. This value must match the <code>name</code> field in the relevant <a href="https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_PromptVariant.html">PromptVariant</a> object.

clientTokenstring

A unique, case-sensitive identifier to ensure that the API request completes no more than one time. 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>.

tagsobject

Any tags that you want to attach to the prompt. For more information, see <a href="https://docs.aws.amazon.com/bedrock/latest/userguide/tagging.html">Tagging resources in Amazon Bedrock</a>.

Response

Success

namestring required

The name of the prompt.

descriptionstring

The description of the prompt.

customerEncryptionKeyArnstring

The Amazon Resource Name (ARN) of the KMS key that you encrypted the prompt with.

defaultVariantstring

The name of the default variant for your prompt.

idstring required

The unique identifier of the prompt.

arnstring required

The Amazon Resource Name (ARN) of the prompt.

versionstring required

The version of the prompt. When you create a prompt, the version created is the <code>DRAFT</code> version.

createdAtstring date-time required

The time at which the prompt was created.

updatedAtstring date-time required

The time at which the prompt was last updated.