Sign in

v1

latestOpenAPI 3.0.0Apache 2.0 License2026-07-1475719557.8 KB

Creates a static snapshot of your prompt that can be deployed to production. For more information, see <a href="https://docs.aws.amazon.com/bedrock/latest/userguide/prompt-management-deploy.html">Deploy prompts using Prompt management by creating versions</a> in the Amazon Bedrock User Guide.

post/prompts/{promptIdentifier}/versions

Path parameters

promptIdentifierstring required

The unique identifier of the prompt that you want to create a version of.

Request body

descriptionstring

A description for the version of the prompt.

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 version of 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

A description for the version.

customerEncryptionKeyArnstring

The Amazon Resource Name (ARN) of the KMS key to encrypt the version of 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.

idstring required

The unique identifier of the prompt.

arnstring required

The Amazon Resource Name (ARN) of the version of the prompt.

versionstring required

The version of the prompt that was created. Versions are numbered incrementally, starting from 1.

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.