---
title: "PUT /applications/{applicationId}"
method: PUT
path: "/applications/{applicationId}"
---

# PUT /applications/{applicationId}

`PUT /applications/{applicationId}`

Updates an existing Amazon Q Business application.

Amazon Q Business applications may securely transmit data for processing across Amazon Web Services Regions within your geography. For more information, see [Cross region inference in Amazon Q Business](https://docs.aws.amazon.com/amazonq/latest/qbusiness-ug/cross-region-inference.html).

An Amazon Q Apps service-linked role will be created if it's absent in the Amazon Web Services account when `QAppsConfiguration` is enabled in the request. For more information, see [Using service-linked roles for Q Apps](https://docs.aws.amazon.com/amazonq/latest/qbusiness-ug/using-service-linked-roles-qapps.html).

## Path parameters

- `applicationId` string, required

## Request body

- object
  - `identityCenterInstanceArn` string — The Amazon Resource Name (ARN) of the IAM Identity Center instance you are either creating for—or connecting to—your Amazon Q Business application.
  - `displayName` string — A name for the Amazon Q Business application.
  - `description` string — A description for the Amazon Q Business application.
  - `roleArn` string — An Amazon Web Services Identity and Access Management (IAM) role that gives Amazon Q Business permission to access Amazon CloudWatch logs and metrics.
  - `attachmentsConfiguration` object — Configuration information for the file upload during chat feature.
    - `attachmentsControlMode` 'ENABLED' | 'DISABLED' — Status information about whether file upload functionality is activated or deactivated for your end user.
  - `qAppsConfiguration` object — Configuration information about Amazon Q Apps.
    - `qAppsControlMode` 'ENABLED' | 'DISABLED' — Status information about whether end users can create and use Amazon Q Apps in the web experience.
  - `personalizationConfiguration` object — Configuration information about chat response personalization. For more information, see <a href="https://docs.aws.amazon.com/amazonq/latest/qbusiness-ug/personalizing-chat-responses.html">Personalizing chat responses</a>.
    - `personalizationControlMode` 'ENABLED' | 'DISABLED' — An option to allow Amazon Q Business to customize chat responses using user specific metadata—specifically, location and job information—in your IAM Identity Center instance.
  - `autoSubscriptionConfiguration` object — Subscription configuration information for an Amazon Q Business application using IAM identity federation for user management.
    - `autoSubscribe` 'ENABLED' | 'DISABLED' — Describes whether automatic subscriptions are enabled for an Amazon Q Business application using IAM identity federation for user management.
    - `defaultSubscriptionType` 'Q_LITE' | 'Q_BUSINESS' — Describes the default subscription type assigned to an Amazon Q Business application using IAM identity federation for user management. If the value for <code>autoSubscribe</code> is set to <code>ENABLED</code> you must select a value for this field.

## Response `200`

Success

- UpdateApplicationResponse

## Other responses

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

---

[API](https://skmtc.net/aws/apis/qbusiness.md) · [All operations](https://skmtc.net/aws/apis/qbusiness/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/aws/qbusiness/versions/82966d6c4053/schema)