--- title: "Changes to Update a Team" method: PATCH path: "/v2/teams/{teamId}" --- # Changes to Update a Team `PATCH /v2/teams/{teamId}` > Every recorded change to this operation, newest first. ## Timeline Changed in 32 of 137 revisions. - **2026-10-22** `2c530c81d9e1`: 2 info - **2026-10-19** `b4c010d0e737`: 1 info - **2026-10-14** `c22a581210d1`: 1 info - **2026-10-08** `b426de1e3932`: 1 info - **2026-10-07** `24be175f4966`: 1 info - **2026-10-03** `2c463a1d98b1`: 5 warning, 2 info - **2026-09-30** `6f68095b42b1`: 1 info - **2026-09-30** `099fbe1f521c`: 1 breaking, 2 info - **2026-09-29** `8ef4901ffe83`: 2 info - **2026-09-19** `3c7345f489a9`: 2 info - **2026-09-17** `10dff3be52ff`: 2 warning, 2 info - **2026-09-03** `f2c3b0a5aef3`: 2 info - **2026-08-31** `e31ea8d3c1e7`: 4 warning - **2026-08-25** `b3ee1929bdbf`: 1 breaking, 1 warning, 2 info - **2026-08-13** `6ed5b7605027`: 2 warning - **2026-08-11** `3c110607c6cb`: 2 info - **2026-08-04** `ed45a5c919e5`: 2 warning, 1 info - **2026-07-31** `e20468c66692`: 1 warning, 2 info - **2026-07-21** `2ae10ee9d21c`: 1 info - **2026-07-14** `314022afff45`: 2 warning - **2026-07-09** `5cd7769cab33`: 2 info - **2026-07-08** `3ff660568354`: 6 warning, 2 info - **2026-06-22** `7bd30e62d868`: 1 info - **2026-06-11** `14b4658f819e`: 1 breaking, 17 warning, 22 info - **2026-02-10** `486a07653d6e`: 2 info - **2026-02-02** `5264f094c3d3`: 1 warning, 4 info - **2026-01-22** `c12186034433`: 3 breaking, 19 warning, 2 info - **2025-11-28** `45991e5c8b6d`: 2 info - **2025-10-09** `50caddad4ae7`: 4 breaking, 7 warning, 28 info - **2025-05-17** `67f6a93c3cd8`: 11 info - **2025-03-19** `37b482c58c92`: 6 breaking, 1 warning, 7 info - **2022-12-06** `8eb562567170`: 7 info ## Changes - **2026-10-22** `2c530c81d9e1`: 2 info - added the non-success response with the status `502` - added the non-success response with the status `503` - **2026-10-19** `b4c010d0e737`: 1 info - the response property `defaultDeploymentProtection` became required for the status `200` - **2026-10-14** `c22a581210d1`: 1 info - added the optional property `membership/isOrgBackingTeamMembership` to the response with the `200` status - **2026-10-08** `b426de1e3932`: 1 info - added the optional property `membership/organizationId` to the response with the `200` status - **2026-10-07** `24be175f4966`: 1 info - added the required property `limited` to the response with the `200` status - **2026-10-03** `2c463a1d98b1`: 5 warning, 2 info - added the new `already_metered` enum value to the `deploymentStorageRollout/cohort` response property for the response status `200` - added the new `extreme` enum value to the `deploymentStorageRollout/cohort` response property for the response status `200` - added the new `medium_plus` enum value to the `deploymentStorageRollout/cohort` response property for the response status `200` - added the new `metered_opt_in` enum value to the `deploymentStorageRollout/cohort` response property for the response status `200` - added the new `retention_opt_out` enum value to the `deploymentStorageRollout/meterReason` response property for the response status `200` - added the optional property `defaultContinuousUsageKind` to the response with the `200` status - removed the `high_retention_opt_in` enum value from the `deploymentStorageRollout/meterReason` response property for the response status `200` - **2026-09-30** `6f68095b42b1`: 1 info - added the optional property `defaultProjectJobs/flag-definitions-present` to the response with the `200` status - **2026-09-30** `099fbe1f521c`: 1 breaking, 2 info - added `subschema #1, subschema #2` to the `saml/roles/additionalProperties/` response property `oneOf` list for the response status `200` - added the non-success response with the status `404` - removed `subschema #1` from the `saml/roles/additionalProperties/` response property `oneOf` list for the response status `200` - **2026-09-29** `8ef4901ffe83`: 2 info - added the new optional request property `defaultExpirationSettings/acknowledgeStorageBilling` - added the new optional request property `defaultExpirationSettings/keepCurrentRetention` - **2026-09-19** `3c7345f489a9`: 2 info - added the non-success response with the status `409` - added the optional property `deploymentStorageRollout` to the response with the `200` status - **2026-09-17** `10dff3be52ff`: 2 warning, 2 info - added the new `AiGatewayUser` enum value to the `defaultRoles/teamPermissions/items/` response property for the response status `200` - added the new `AiGatewayUser` enum value to the `membership/teamPermissions/items/` response property for the response status `200` - removed the `AiGatewayApiKeyOwnedBySelf` enum value from the `defaultRoles/teamPermissions/items/` response property for the response status `200` - removed the `AiGatewayApiKeyOwnedBySelf` enum value from the `membership/teamPermissions/items/` response property for the response status `200` - **2026-09-03** `f2c3b0a5aef3`: 2 info - added the new optional request property `strictConnectors` - added the optional property `strictConnectors` to the response with the `200` status - **2026-08-31** `e31ea8d3c1e7`: 4 warning - added the new `AiGatewayTranscriptsManager` enum value to the `defaultRoles/teamPermissions/items/` response property for the response status `200` - added the new `AiGatewayTranscriptsManager` enum value to the `membership/teamPermissions/items/` response property for the response status `200` - added the new `AiGatewayTranscriptsViewer` enum value to the `defaultRoles/teamPermissions/items/` response property for the response status `200` - added the new `AiGatewayTranscriptsViewer` enum value to the `membership/teamPermissions/items/` response property for the response status `200` - **2026-08-25** `b3ee1929bdbf`: 1 breaking, 1 warning, 2 info - added the pattern `^[0-9a-f]+$` to the request property `avatar` - the `avatar` request property's maxLength was set to `40` - the request property `avatar` became nullable - the `avatar` request property format was generalized from `regex` to no format - **2026-08-13** `6ed5b7605027`: 2 warning - added the new `WorkflowDecryptor` enum value to the `defaultRoles/teamPermissions/items/` response property for the response status `200` - added the new `WorkflowDecryptor` enum value to the `membership/teamPermissions/items/` response property for the response status `200` - **2026-08-11** `3c110607c6cb`: 2 info - added the new optional request property `disjunctiveProductionSecretPolicy` - added the optional property `disjunctiveProductionSecretPolicy` to the response with the `200` status - **2026-08-04** `ed45a5c919e5`: 2 warning, 1 info - added the new `ConnectorManager` enum value to the `defaultRoles/teamPermissions/items/` response property for the response status `200` - added the new `ConnectorManager` enum value to the `membership/teamPermissions/items/` response property for the response status `200` - added the required property `billing` to the response with the `200` status - **2026-07-31** `e20468c66692`: 1 warning, 2 info - added the new `basic` enum value to the `resourceConfig/buildMachine/default` response property for the response status `200` - added the new `basic` enum value to the request property `resourceConfig/buildMachine/default` - added the optional property `orgRootTeamId` to the response with the `200` status - **2026-07-21** `2ae10ee9d21c`: 1 info - added the non-success response with the status `410` - **2026-07-14** `314022afff45`: 2 warning - added the new `AiGatewayBudgetManager` enum value to the `defaultRoles/teamPermissions/items/` response property for the response status `200` - added the new `AiGatewayBudgetManager` enum value to the `membership/teamPermissions/items/` response property for the response status `200` - **2026-07-09** `5cd7769cab33`: 2 info - added the new optional request property `strictPasswordProtectionSettings` - added the optional property `strictPasswordProtectionSettings` to the response with the `200` status - **2026-07-08** `3ff660568354`: 6 warning, 2 info - added the new `AiGatewayApiKeyOwnedBySelf` enum value to the `defaultRoles/teamPermissions/items/` response property for the response status `200` - added the new `AiGatewayApiKeyOwnedBySelf` enum value to the `membership/teamPermissions/items/` response property for the response status `200` - added the new `AiGatewayCredits` enum value to the `defaultRoles/teamPermissions/items/` response property for the response status `200` - added the new `AiGatewayCredits` enum value to the `membership/teamPermissions/items/` response property for the response status `200` - added the new `AiGatewaySettings` enum value to the `defaultRoles/teamPermissions/items/` response property for the response status `200` - added the new `AiGatewaySettings` enum value to the `membership/teamPermissions/items/` response property for the response status `200` - the request property `defaultPassport/deploymentType` became optional - the `deploymentType` request property default value `all` was added - **2026-06-22** `7bd30e62d868`: 1 info - added the optional property `resourceConfig/serverlessFunctionMaxMemorySize` to the response with the `200` status - **2026-06-11** `14b4658f819e`: 1 breaking, 17 warning, 22 info - the response property `membership` became optional for the status `200` - added the new `OrgAdmin` enum value to the `defaultRoles/teamPermissions/items/` response property for the response status `200` - added the new `OrgAdmin` enum value to the `membership/teamPermissions/items/` response property for the response status `200` - added the new `OrgViewer` enum value to the `defaultRoles/teamPermissions/items/` response property for the response status `200` - added the new `OrgViewer` enum value to the `membership/teamPermissions/items/` response property for the response status `200` - added the new `account-update` enum value to the `membership/joinedFrom/origin` response property for the response status `200` - added the new `elastic` enum value to the `resourceConfig/buildMachine/default` response property for the response status `200` - added the new `nsnb-hobby-upgrade` enum value to the `membership/joinedFrom/origin` response property for the response status `200` - added the new `nsnb-invite` enum value to the `membership/joinedFrom/origin` response property for the response status `200` - added the new `nsnb-redeploy` enum value to the `membership/joinedFrom/origin` response property for the response status `200` - added the new `nsnb-redeploy-attribution-card` enum value to the `membership/joinedFrom/origin` response property for the response status `200` - added the new `nsnb-request-access` enum value to the `membership/joinedFrom/origin` response property for the response status `200` - added the new `nsnb-viewer-upgrade` enum value to the `membership/joinedFrom/origin` response property for the response status `200` - added the new `undefined` enum value to the `enablePreviewFeedback` response property for the response status `200` - added the new `undefined` enum value to the `enableProductionFeedback` response property for the response status `200` - added the new `undefined` enum value to the `hideIpAddresses` response property for the response status `200` - added the new `undefined` enum value to the `hideIpAddressesInLogDrains` response property for the response status `200` - added the new `undefined` enum value to the `sensitiveEnvironmentVariablePolicy` response property for the response status `200` - added the new optional request property `defaultPassport` - added the new optional request property `defaultProjectJobs` - added the new optional request property `deploymentPolicy` - added the new optional request property `disableRepositoryDispatchEvents` - added the new optional request property `dpAccessRequestsMode` - added the new optional request property `requireVerifiedCommits` - added the new optional request property `strictShareableLinks` - added the new `elastic` enum value to the request property `resourceConfig/buildMachine/default` - added the optional property `apiKeysInvalidatedAt` to the response with the `200` status - added the optional property `appTokensInvalidatedAt` to the response with the `200` status - added the optional property `defaultPassport` to the response with the `200` status - added the optional property `defaultProjectJobs` to the response with the `200` status - added the optional property `deploymentPolicy` to the response with the `200` status - added the optional property `disableRepositoryDispatchEvents` to the response with the `200` status - added the optional property `dpAccessRequestsMode` to the response with the `200` status - added the optional property `integrationTokensInvalidatedAt` to the response with the `200` status - added the optional property `ipBuckets/items/default` to the response with the `200` status - added the optional property `parentId` to the response with the `200` status - added the optional property `personalAccessTokensInvalidatedAt` to the response with the `200` status - added the optional property `requireVerifiedCommits` to the response with the `200` status - added the optional property `resourceConfig/customEnvironmentsPerProject` to the response with the `200` status - added the optional property `strictShareableLinks` to the response with the `200` status - **2026-02-10** `486a07653d6e`: 2 info - added the new optional request property `resourceConfig` - added the optional property `resourceConfig/buildMachine` to the response with the `200` status - **2026-02-02** `5264f094c3d3`: 1 warning, 4 info - added the new `nsnb-auto-approve` enum value to the `membership/joinedFrom/origin` response property for the response status `200` - added the new optional request property `nsnbConfig` - added the optional property `nsnbConfig` to the response with the `200` status - added the optional property `saml/connection/syncState` to the response with the `200` status - added the optional property `saml/directory/syncState` to the response with the `200` status - **2026-01-22** `c12186034433`: 3 breaking, 19 warning, 2 info - request body became required - the response property `defaultDeploymentProtection/passwordProtection` became nullable for the status `200` - the response property `defaultDeploymentProtection/ssoProtection` became nullable for the status `200` - added the new `false` enum value to the `connect/enabled` response property for the response status `200` - added the new `false` enum value to the `disableHardAutoBlocks/oneOf[subschema #2]/` response property for the response status `200` - added the new `false` enum value to the `hideIpAddresses` response property for the response status `200` - added the new `false` enum value to the `hideIpAddressesInLogDrains` response property for the response status `200` - added the new `false` enum value to the `platform` response property for the response status `200` - added the new `false` enum value to the `remoteCaching/enabled` response property for the response status `200` - added the new `false` enum value to the `resourceConfig/buildEntitlements/enhancedBuilds` response property for the response status `200` - added the new `false` enum value to the `resourceConfig/elasticConcurrencyEnabled` response property for the response status `200` - added the new `false` enum value to the `saml/enforced` response property for the response status `200` - added the new `true` enum value to the `connect/enabled` response property for the response status `200` - added the new `true` enum value to the `disableHardAutoBlocks/oneOf[subschema #2]/` response property for the response status `200` - added the new `true` enum value to the `hideIpAddresses` response property for the response status `200` - added the new `true` enum value to the `hideIpAddressesInLogDrains` response property for the response status `200` - added the new `true` enum value to the `membership/confirmed` response property for the response status `200` - added the new `true` enum value to the `platform` response property for the response status `200` - added the new `true` enum value to the `remoteCaching/enabled` response property for the response status `200` - added the new `true` enum value to the `resourceConfig/buildEntitlements/enhancedBuilds` response property for the response status `200` - added the new `true` enum value to the `resourceConfig/elasticConcurrencyEnabled` response property for the response status `200` - added the new `true` enum value to the `saml/enforced` response property for the response status `200` - added the new optional request property `strictDeploymentProtectionSettings` - added the optional property `strictDeploymentProtectionSettings` to the response with the `200` status - **2025-11-28** `45991e5c8b6d`: 2 info - added the optional property `saml/connection/lastSyncedAt` to the response with the `200` status - added the optional property `saml/directory/lastSyncedAt` to the response with the `200` status - **2025-10-09** `50caddad4ae7`: 4 breaking, 7 warning, 28 info - removed the required property `created` from the response with the `200` status - removed the required property `limited` from the response with the `200` status - removed the required property `limitedBy` from the response with the `200` status - removed the required property `membership/confirmedAt` from the response with the `200` status - removed the optional property `mfaEnforced` from the response with the `200` status - added the new `IntegrationManager` enum value to the `membership/teamPermissions/items/` response property for the response status `200` - added the new `V0Builder` enum value to the `membership/teamPermissions/items/` response property for the response status `200` - added the new `V0Chatter` enum value to the `membership/teamPermissions/items/` response property for the response status `200` - added the new `V0Viewer` enum value to the `membership/teamPermissions/items/` response property for the response status `200` - added the new `VIEWER_FOR_PLUS` enum value to the `membership/role` response property for the response status `200` - added the new `VIEWER_FOR_PLUS` enum value to the `membership/teamRoles/items/` response property for the response status `200` - added the new optional request property `defaultDeploymentProtection` - added the new optional request property `defaultExpirationSettings` - added the new `VIEWER_FOR_PLUS` enum value to the request property `saml/roles/additionalProperties/anyOf[subschema #1]/` - added the non-success response with the status `428` - removed the non-success response with the status `404` - added the optional property `connect` to the response with the `200` status - added the optional property `defaultDeploymentProtection` to the response with the `200` status - added the optional property `defaultExpirationSettings` to the response with the `200` status - added the optional property `defaultRoles` to the response with the `200` status - added the optional property `disableHardAutoBlocks` to the response with the `200` status - added the optional property `emailDomain` to the response with the `200` status - added the optional property `enablePreviewFeedback` to the response with the `200` status - added the optional property `enableProductionFeedback` to the response with the `200` status - added the optional property `hideIpAddresses` to the response with the `200` status - added the optional property `hideIpAddressesInLogDrains` to the response with the `200` status - added the optional property `inviteCode` to the response with the `200` status - added the optional property `ipBuckets` to the response with the `200` status - added the optional property `platform` to the response with the `200` status - added the optional property `previewDeploymentSuffix` to the response with the `200` status - added the optional property `remoteCaching` to the response with the `200` status - added the optional property `resourceConfig` to the response with the `200` status - added the optional property `saml/defaultRedirectUri` to the response with the `200` status - added the optional property `saml/roles` to the response with the `200` status - added the optional property `sensitiveEnvironmentVariablePolicy` to the response with the `200` status - added the required property `creatorId` to the response with the `200` status - added the required property `description` to the response with the `200` status - added the required property `stagingPrefix` to the response with the `200` status - added the required property `updatedAt` to the response with the `200` status - **2025-05-17** `67f6a93c3cd8`: 11 info - added the optional property `mfaEnforced` to the response with the `200` status - added the optional property `saml` to the response with the `200` status - added the required property `avatar` to the response with the `200` status - added the required property `created` to the response with the `200` status - added the required property `createdAt` to the response with the `200` status - added the required property `id` to the response with the `200` status - added the required property `limited` to the response with the `200` status - added the required property `limitedBy` to the response with the `200` status - added the required property `membership` to the response with the `200` status - added the required property `name` to the response with the `200` status - added the required property `slug` to the response with the `200` status - **2025-03-19** `37b482c58c92`: 6 breaking, 1 warning, 7 info - removed the enum value `BILLING` of the request property `saml/roles/additionalProperties/` - removed the enum value `DEVELOPER` of the request property `saml/roles/additionalProperties/` - removed the enum value `MEMBER` of the request property `saml/roles/additionalProperties/` - removed the enum value `OWNER` of the request property `saml/roles/additionalProperties/` - removed the enum value `VIEWER` of the request property `saml/roles/additionalProperties/` - the `saml/roles/additionalProperties/` request property type changed from `string` to no type - removed the request property `connect` - added the new optional `query` request parameter `slug` - added the new optional request property `enableProductionFeedback` - added the new optional request property `hideIpAddresses` - added the new optional request property `hideIpAddressesInLogDrains` - added the new optional request property `sensitiveEnvironmentVariablePolicy` - added `subschema #1, subschema #2` to the `saml/roles/additionalProperties/` request property `anyOf` list - added the non-success response with the status `401` - **2022-12-06** `8eb562567170`: 7 info - added the new optional request property `connect` - added the new optional request property `enablePreviewFeedback` - added the new optional request property `remoteCaching` - added the new `BILLING` enum value to the request property `saml/roles/additionalProperties/` - added the new `DEVELOPER` enum value to the request property `saml/roles/additionalProperties/` - added the new `VIEWER` enum value to the request property `saml/roles/additionalProperties/` - the `name` request property's minLength was decreased from `1` to `0` --- [Operation](https://skmtc.dev/vercel/apis/api/docs/v2/teams/:teamId/patch.md) - [API](https://skmtc.dev/vercel/apis/api.md) - [Page](https://skmtc.dev/vercel/apis/api/changes/v2/teams/:teamId/patch)