---
title: "POST /collaborations/{collaborationIdentifier}/changeRequests"
method: POST
path: "/collaborations/{collaborationIdentifier}/changeRequests"
---

# POST /collaborations/{collaborationIdentifier}/changeRequests

`POST /collaborations/{collaborationIdentifier}/changeRequests`

Creates a new change request to modify an existing collaboration. This enables post-creation modifications to collaborations through a structured API-driven approach.

## Path parameters

- `collaborationIdentifier` string, required

## Request body

- object
  - `changes` ChangeInput[], required — The list of changes to apply to the collaboration. Each change specifies the type of modification and the details of what should be changed.
    - `specificationType` 'MEMBER' | 'COLLABORATION', required — The type of specification for the change. Currently supports <code>MEMBER</code> for member-related changes.
    - `specification` object, required — The specification details for the change. The structure depends on the specification type.
      - `member` object — The member change specification when the change type is <code>MEMBER</code>.
        - `accountId` string, required — The Amazon Web Services account ID of the member to add to the collaboration.
        - `memberAbilities` MemberAbility[], required — <p>The abilities granted to the collaboration member. These determine what actions the member can perform within the collaboration.</p> <note> <p>The following values are currently not supported: <code>CAN_QUERY</code> and <code>CAN_RUN_JOB</code>. </p> <p>Set the value of <code>memberAbilities</code> to <code>[]</code> to allow a member to contribute data.</p> <p>Set the value of <code>memberAbilities</code> to <code>[CAN_RECEIVE_RESULTS]</code> to allow a member to contribute data and receive results.</p> </note>
        - `mlMemberAbilities` MLMemberAbilities — The ML member abilities for a collaboration member.
          - `customMLMemberAbilities` CustomMLMemberAbility[], required — The custom ML member abilities for a collaboration member.
        - `paymentConfiguration` PaymentConfiguration — An object representing the collaboration member's payment responsibilities set by the collaboration creator.
          - `queryCompute` object, required — The collaboration member's payment responsibilities set by the collaboration creator for query compute costs.
            - `isResponsible` boolean, required — <p>Indicates whether the collaboration creator has configured the collaboration member to pay for query compute costs (<code>TRUE</code>) or has not configured the collaboration member to pay for query compute costs (<code>FALSE</code>).</p> <p>One or more members can be configured as payer candidates for query compute costs.</p> <p>If the collaboration creator hasn't specified anyone as the member paying for query compute costs, then the member who can query is the default payer.</p>
          - `machineLearning` object — An object representing the collaboration member's machine learning payment responsibilities set by the collaboration creator.
            - `modelTraining` object — The payment responsibilities accepted by the member for model training.
              - …
            - `modelInference` object — The payment responsibilities accepted by the member for model inference.
              - …
            - `syntheticDataGeneration` object — The payment configuration for machine learning synthetic data generation.
              - …
          - `jobCompute` object — The compute configuration for the job.
            - `isResponsible` boolean, required — <p>Indicates whether the collaboration creator has configured the collaboration member to pay for query and job compute costs (<code>TRUE</code>) or has not configured the collaboration member to pay for query and job compute costs (<code>FALSE</code>).</p> <p>One or more members can be configured as payer candidates for query and job compute costs.</p> <p>An error is returned if the collaboration creator sets a <code>FALSE</code> value for the member who can run queries and jobs.</p>
        - `displayName` string — Specifies the display name that will be shown for this member in the collaboration. While this field is required when inviting new members, it becomes optional when modifying abilities of existing collaboration members.
      - `collaboration` object — The collaboration configuration changes being requested. Currently, this only supports modifying which change types are auto-approved for the collaboration.
        - `autoApprovedChangeTypes` AutoApprovedChangeType[] — Defines requested updates to properties of the collaboration. Currently, this only supports modifying which change types are auto-approved for the collaboration.

## Response `200`

Success

- CreateCollaborationChangeRequestOutput
  - `collaborationChangeRequest` CollaborationChangeRequest, required — Represents a request to modify a collaboration. Change requests enable structured modifications to collaborations after they have been created.
    - `id` string, required — The unique identifier for the change request.
    - `collaborationId` string, required — The unique identifier for the collaboration being modified.
    - `createTime` string, date-time, required — The time when the change request was created.
    - `updateTime` string, date-time, required — The time when the change request was last updated.
    - `status` 'PENDING' | 'APPROVED' | 'CANCELLED' | 'DENIED' | 'COMMITTED', required — The current status of the change request. Valid values are <code>PENDING</code>, <code>APPROVED</code>, <code>DENIED</code>, <code>COMMITTED</code>, and <code>CANCELLED</code>.
    - `isAutoApproved` boolean, required — Whether the change request was automatically approved based on the collaboration's auto-approval settings.
    - `changes` Change[], required — The list of changes specified in this change request.
      - `specificationType` 'MEMBER' | 'COLLABORATION', required — The type of specification for this change.
      - `specification` object, required — The specification details for this change.
        - `member` object — The member change specification when the change type is <code>MEMBER</code>.
          - `accountId` string, required — The Amazon Web Services account ID of the member to add to the collaboration.
          - `memberAbilities` MemberAbility[], required — <p>The abilities granted to the collaboration member. These determine what actions the member can perform within the collaboration.</p> <note> <p>The following values are currently not supported: <code>CAN_QUERY</code> and <code>CAN_RUN_JOB</code>. </p> <p>Set the value of <code>memberAbilities</code> to <code>[]</code> to allow a member to contribute data.</p> <p>Set the value of <code>memberAbilities</code> to <code>[CAN_RECEIVE_RESULTS]</code> to allow a member to contribute data and receive results.</p> </note>
          - `mlMemberAbilities` MLMemberAbilities — The ML member abilities for a collaboration member.
            - `customMLMemberAbilities` CustomMLMemberAbility[], required — The custom ML member abilities for a collaboration member.
          - `paymentConfiguration` PaymentConfiguration — An object representing the collaboration member's payment responsibilities set by the collaboration creator.
            - `queryCompute` object, required — The collaboration member's payment responsibilities set by the collaboration creator for query compute costs.
              - …
            - `machineLearning` object — An object representing the collaboration member's machine learning payment responsibilities set by the collaboration creator.
              - …
            - `jobCompute` object — The compute configuration for the job.
              - …
          - `displayName` string — Specifies the display name that will be shown for this member in the collaboration. While this field is required when inviting new members, it becomes optional when modifying abilities of existing collaboration members.
        - `collaboration` object — The collaboration configuration changes being requested. Currently, this only supports modifying which change types are auto-approved for the collaboration.
          - `autoApprovedChangeTypes` AutoApprovedChangeType[] — Defines requested updates to properties of the collaboration. Currently, this only supports modifying which change types are auto-approved for the collaboration.
      - `types` ChangeType[], required — The list of change types that were applied.
    - `approvals` object — A list of approval details from collaboration members, including approval status and multi-party approval workflow information.

## Other responses

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

---

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