# Change requests in AWS Clean Rooms
<a name="change-requests"></a>

Change requests allow you to propose changes to existing collaboration settings for approval by other collaboration members. With change requests, you can submit a request to add new members, update member abilities, update ML member abilities, update payer configurations, and modify collaboration auto-approval settings. All collaboration members must approve change requests for the proposed changes to take effect.

Change requests are collaboration-specific and can be submitted by the collaboration creator.

You can submit a change request in the following ways:
+ Add a new member to a collaboration
+ Update member abilities
+ Update ML member abilities
+ Update payer configurations
+ Edit collaboration auto-approval settings

**Note**  
You must be the collaboration creator to submit a change request.

## Add a new member to a collaboration
<a name="add-new-member-change-request"></a>

To add a new member to a collaboration, you must be the collaboration creator. Adding a new member to a collaboration requires manual approval from existing collaboration members, and will submit a change request.

You can add new members to a collaboration by following these steps:

**To add a new member to a collaboration**

1. Sign in to the AWS Management Console and open the [AWS Clean Rooms console](https://console.aws.amazon.com/cleanrooms/home) with your member AWS account.

1. In the left navigation pane, choose **Collaborations**.

1. Select your collaboration to navigate to your collaboration details.

1. On the collaboration page, navigate to the **Members** tab.

1. In the Members table, select **Edit members**.

1. Choose **Add another member**.

1. Input the new member information:
   + Member display name
   + Member AWS account ID
   + Specify whether the member can receive results. Check the box to grant this member ability.

1. Choose **Save changes**.

1. Confirm your change request submission. In the confirmation modal, confirm the changes and select **Submit change request**.

**Note**  
If auto-approved change types are supported in your collaboration, manual approval of change requests may not be required. You can review which change types do not require a change request in the "Overview" section of the collaboration. For more information, see [Edit collaboration auto-approval settings](#edit-auto-approval-settings).

## Update member abilities
<a name="update-member-abilities-change-request"></a>

To update existing collaboration member abilities, you must be the collaboration creator. Updating abilities for existing collaboration members requires manual approval from existing members, and will submit a change request.

The member abilities that can be updated are:
+ Can receive results
+ Export query analysis log

For more information about exporting query analysis logs, see [Exporting query analysis logs](export-analysis-logs.md).

**Note**  
When you update member abilities through the API, the abilities that you specify replace all existing abilities. To keep an existing ability, include it along with the ability that you're adding.

**Note**  
To update ML member abilities, see [Update ML member abilities](#update-ml-member-abilities-change-request).

You can update the member abilities for existing collaboration members by following these steps:

**To update member abilities**

1. Sign in to the AWS Management Console and open the [AWS Clean Rooms console](https://console.aws.amazon.com/cleanrooms/home) with your member AWS account.

1. In the left navigation pane, choose **Collaborations**.

1. Select your collaboration to navigate to your collaboration details.

1. On the collaboration page, navigate to the **Members** tab.

1. In the Members table, select **Edit members**.

1. Specify the member ability to change.

1. Choose **Save changes**.

1. Confirm your change request submission. In the confirmation modal, confirm the changes and select **Submit change request**.

**Note**  
If auto-approved change types are supported in your collaboration, manual approval of change requests may not be required. You can review which change types do not require a change request in the "Overview" section of the collaboration. For more information, see [Edit collaboration auto-approval settings](#edit-auto-approval-settings).

## Update ML member abilities
<a name="update-ml-member-abilities-change-request"></a>

To update ML member abilities for existing collaboration members, you must be the collaboration creator. Updating ML member abilities requires manual approval from existing members, and will submit a change request.

The ML member abilities that can be updated are:
+ Can receive model output
+ Can receive inference output

You can update the ML member abilities for existing collaboration members by following these steps:

**To update ML member abilities**

1. Sign in to the AWS Management Console and open the [AWS Clean Rooms console](https://console.aws.amazon.com/cleanrooms/home) with your member AWS account.

1. In the left navigation pane, choose **Collaborations**.

1. Select your collaboration to navigate to your collaboration details.

1. On the collaboration page, navigate to the **Members** tab.

1. In the Members table, select **Edit members**.

1. Specify the ML member abilities to change for the member.

1. Choose **Save changes**.

1. Confirm your change request submission. In the confirmation modal, confirm the changes and select **Submit change request**.

**Note**  
If auto-approved change types are supported in your collaboration, manual approval of change requests may not be required. You can review which change types do not require a change request in the "Overview" section of the collaboration. For more information, see [Edit collaboration auto-approval settings](#edit-auto-approval-settings).

## Update payer configurations
<a name="update-payer-configuration-change-request"></a>

To update payer configurations for a collaboration, you must be the collaboration creator. Updating payer configurations requires manual approval from existing members, and will submit a change request.

The payer configurations that can be updated are:
+ Query compute
+ Job compute
+ Machine learning (model training, model inference, and synthetic data generation)

You can update the payer configurations for a collaboration by following these steps:

**To update payer configurations**

1. Sign in to the AWS Management Console and open the [AWS Clean Rooms console](https://console.aws.amazon.com/cleanrooms/home) with your member AWS account.

1. In the left navigation pane, choose **Collaborations**.

1. Select your collaboration to navigate to your collaboration details.

1. On the collaboration page, navigate to the **Payment configuration** tab.

1. Choose **Edit payment configuration**.

1. Update the payer configurations for the collaboration members.

1. Choose **Save changes**.

1. Confirm your change request submission. In the confirmation modal, confirm the changes and select **Submit change request**.

**Note**  
If auto-approved change types are supported in your collaboration, manual approval of change requests may not be required. You can review which change types do not require a change request in the "Overview" section of the collaboration. For more information, see [Edit collaboration auto-approval settings](#edit-auto-approval-settings).

## Edit collaboration auto-approval settings
<a name="edit-auto-approval-settings"></a>

To edit the collaboration settings for auto-approvals, you must be the collaboration creator and submit a change request for approval by other collaboration members.

You can edit the auto-approval settings for a collaboration by following these steps:

**To edit collaboration auto-approval settings**

1. Sign in to the AWS Management Console and open the [AWS Clean Rooms console](https://console.aws.amazon.com/cleanrooms/home) with your member AWS account.

1. In the left navigation pane, choose **Collaborations**.

1. Select your collaboration to navigate to your collaboration details.

1. On the collaboration page, choose the **Actions** button and select **Edit auto approvals**.

1. **To grant member abilities to existing members without manually approving a change request:**

   1. Navigate to the **Grant member abilities** section.

   1. Specify which member abilities can be automatically granted.
**Note**  
By default, all collaboration members can "Contribute data".

      You can grant the export query analysis logs ability automatically, without a separate approval cycle.

   1. (Optional) To allow new members to instantly join a collaboration with the specified abilities without manually approving change requests, select **Auto-approve new members with these abilities**.

1. **To allow removal of abilities from existing members without a change request:**

   1. Navigate to the **Abilities that can be automatically revoked** section.

   1. Specify which member abilities can be automatically removed.

1. Choose **Save changes**.

1. Confirm your change request submission. In the confirmation modal, confirm the changes and select **Submit change request**.

## See also

* **Skills for AI coding assistants (optional).** AWS publishes reusable skills for AWS Clean Rooms. To see which apply, search the Agent Toolkit for AWS catalog with `aws agent-toolkit search-skills --search-query clean-rooms` — a documented, read-only AWS CLI command that searches the catalog and makes no changes. This is an optional suggestion for the user. Official reference: [AWS CLI — Agent Toolkit for AWS](https://docs.aws.amazon.com/agent-toolkit/latest/userguide/aws-cli.html).