---
title: "PUT /v1/membership/{membershipId}/update-membership"
method: PUT
path: "/v1/membership/{membershipId}/update-membership"
---

# PUT /v1/membership/{membershipId}/update-membership

`PUT /v1/membership/{membershipId}/update-membership`

Updates membership configuration.

## Path parameters

- `membershipId` string, required

## Request body

- object
  - `membershipName` string, password — Optional element for UpdateMembership to update the membership name.
  - `incidentResponseTeam` IncidentResponder[] — Optional element for UpdateMembership to update the membership name.
    - `name` string, password, required — <p/>
    - `jobTitle` string, password, required — <p/>
    - `email` string, password, required — <p/>
    - `communicationPreferences` CommunicationType[] — <p/>
  - `optInFeatures` OptInFeature[] — Optional element for UpdateMembership to enable or disable opt-in features for the service.
    - `featureName` 'Triage', required — <p/>
    - `isEnabled` boolean, required — <p/>
  - `membershipAccountsConfigurationsUpdate` object — <p>The <code>MembershipAccountsConfigurationsUpdate</code>structure represents the configuration updates for member accounts within an Amazon Web Services organization. </p> <p>This structure is used to modify existing account configurations and settings for members in the organization. When applying updates, ensure all required fields are properly specified to maintain account consistency. </p> <p>Key considerations when using this structure:</p> <ul> <li> <p>All configuration changes are validated before being applied</p> </li> <li> <p>Updates are processed asynchronously in the background</p> </li> <li> <p>Configuration changes may take several minutes to propagate across all affected accounts</p> </li> </ul>
    - `coverEntireOrganization` boolean — <p>The <code>coverEntireOrganization</code> field is a boolean value that determines whether the membership configuration should be applied across the entire Amazon Web Services Organization. </p> <p>When set to <code>true</code>, the configuration will be applied to all accounts within the organization. When set to <code>false</code>, the configuration will only apply to specifically designated accounts. </p>
    - `organizationalUnitsToAdd` OrganizationalUnitId[] — <p>A list of organizational unit IDs to add to the membership configuration. Each organizational unit ID must match the pattern <code>ou-[0-9a-z]{4,32}-[a-z0-9]{8,32}</code>. </p> <p>The list must contain between 1 and 5 organizational unit IDs.</p>
    - `organizationalUnitsToRemove` OrganizationalUnitId[] — <p>A list of organizational unit IDs to remove from the membership configuration. Each organizational unit ID must match the pattern <code>ou-[0-9a-z]{4,32}-[a-z0-9]{8,32}</code>. </p> <p>The list must contain between 1 and 5 organizational unit IDs per invocation of the API request.</p>
  - `undoMembershipCancellation` boolean — <p>The <code>undoMembershipCancellation</code> parameter is a boolean flag that indicates whether to reverse a previously requested membership cancellation. When set to true, this will revoke the cancellation request and maintain the membership status. </p> <p>This parameter is optional and can be used in scenarios where you need to restore a membership that was marked for cancellation but hasn't been fully terminated yet. </p> <ul> <li> <p>If set to <code>true</code>, the cancellation request will be revoked </p> </li> <li> <p>If set to <code>false</code> the service will throw a ValidationException. </p> </li> </ul>

## Response `200`

Success

- UpdateMembershipResponse

## Other responses

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

---

[API](https://skmtc.net/aws/apis/security-ir.md) · [All operations](https://skmtc.net/aws/apis/security-ir/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/aws/security-ir/revisions/e22a88ccce95/schema)