---
title: "PUT /configuration-bundles/{bundleId}"
method: PUT
path: "/configuration-bundles/{bundleId}"
---

# PUT /configuration-bundles/{bundleId}

`PUT /configuration-bundles/{bundleId}`

Updates a configuration bundle by creating a new version with the specified changes. Each update creates a new version in the version history.

## Path parameters

- `bundleId` string, required

## Request body

- object
  - `clientToken` string — A unique, case-sensitive identifier to ensure that the API request completes no more than one time. If you don't specify this field, a value is randomly generated for you. If this token matches a previous request, the service ignores the request, but doesn't return an error. For more information, see <a href="https://docs.aws.amazon.com/AWSEC2/latest/APIReference/Run_Instance_Idempotency.html">Ensuring idempotency</a>.
  - `bundleName` string — The updated name for the configuration bundle.
  - `description` string, password — The updated description for the configuration bundle.
  - `components` object — The updated component configurations. Creates a new version of the bundle.
  - `parentVersionIds` ConfigurationBundleVersion[] — A list of parent version identifiers for lineage tracking. Regular commits have a single parent. Merge commits have two parents: the target branch parent and the source branch parent. If the branch already exists, the first parent must be the latest version on that branch.
  - `branchName` string — The branch name for this version. If not specified, inherits the parent's branch or defaults to <code>mainline</code>.
  - `commitMessage` string — A commit message describing the changes in this version.
  - `createdBy` object — The source that created a configuration bundle version.
    - `name` string — The name of the source (for example, <code>user</code>, <code>optimization-job</code>, or <code>system</code>).
    - `arn` string — The Amazon Resource Name (ARN) of the source, if applicable (for example, a user ARN or optimization job ARN).
  - `kmsKeyArn` string — Optional KMS key ARN for encrypting component configurations. If provided, components will be encrypted with this key. If the bundle already has a KMS key, this rotates to the new key.

## Response `200`

Success

- UpdateConfigurationBundleResponse
  - `bundleArn` string, required — The Amazon Resource Name (ARN) of the updated configuration bundle.
  - `bundleId` string, required — The unique identifier of the updated configuration bundle.
  - `versionId` string, required — The new version identifier created by this update.
  - `updatedAt` string, date-time, required — The timestamp when the configuration bundle was updated.

## Other responses

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

---

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