diff --git a/schema/dereferenced/repos.json b/schema/dereferenced/repos.json
index 59bf0a05..c1619fb8 100644
--- a/schema/dereferenced/repos.json
+++ b/schema/dereferenced/repos.json
@@ -413,57 +413,54 @@
       "type": "array",
       "items": {
         "description": "A team entry",
-        "type": "object",
-        "properties": {
-          "name": {
-            "type": "string",
-            "description": "The name of the team."
-          },
-          "description": {
-            "type": "string",
-            "description": "The description of the team."
-          },
-          "maintainers": {
-            "type": "array",
-            "description": "List GitHub usernames for organization members who will become team maintainers.",
-            "items": {
-              "type": "string"
+        "allOf": [
+          {
+            "type": "object",
+            "properties": {
+              "permission": {
+                "type": "string",
+                "description": "The permission to grant the team on this repository. We accept the following permissions to be set: `pull`, `triage`, `push`, `maintain`, `admin` and you can also specify a custom repository role name, if the owning organization has defined any. If no permission is specified, the team's `permission` attribute will be used to determine what permission to grant the team on this repository."
+              }
             }
           },
-          "repo_names": {
-            "type": "array",
-            "description": "The full name (e.g., \"organization-name/repository-name\") of repositories to add the team to.",
-            "items": {
-              "type": "string"
+          {
+            "type": "object",
+            "required": [
+              "name"
+            ],
+            "properties": {
+              "name": {
+                "description": "The name (or slug) of the team to grant access to the repo.",
+                "type": "string"
+              },
+              "privacy": {
+                "description": "The level of privacy the team should have when it is created by safe-settings. The options are `secret` (visible only to organization owners and members of the team) or `closed` (visible to all members of the organization).",
+                "type": "string",
+                "enum": [
+                  "secret",
+                  "closed"
+                ]
+              },
+              "external_group": {
+                "description": "The display name of an external IdP group to link to this team.",
+                "type": "string"
+              },
+              "exclude": {
+                "description": "Exclude this team from repos whose names match one of these glob patterns.",
+                "type": "array",
+                "items": {
+                  "type": "string"
+                }
+              },
+              "include": {
+                "description": "Apply this team only to repos whose names match one of these glob patterns.",
+                "type": "array",
+                "items": {
+                  "type": "string"
+                }
+              }
             }
-          },
-          "privacy": {
-            "type": "string",
-            "description": "The level of privacy this team should have. The options are:  \n**For a non-nested team:**  \n * `secret` - only visible to organization owners and members of this team.  \n * `closed` - visible to all members of this organization.  \nDefault: `secret`  \n**For a parent or child team:**  \n * `closed` - visible to all members of this organization.  \nDefault for child team: `closed`",
-            "enum": [
-              "secret",
-              "closed"
-            ]
-          },
-          "notification_setting": {
-            "type": "string",
-            "description": "The notification setting the team has chosen. The options are:  \n * `notifications_enabled` - team members receive notifications when the team is @mentioned.  \n * `notifications_disabled` - no one receives notifications.  \nDefault: `notifications_enabled`",
-            "enum": [
-              "notifications_enabled",
-              "notifications_disabled"
-            ]
-          },
-          "parent_team_id": {
-            "type": "integer",
-            "description": "The ID of a team to set as the parent team."
-          },
-          "parent_team_slug": {
-            "type": "string",
-            "description": "The slug of a team to set as the parent team. Ignored when `parent_team_id` is also provided."
           }
-        },
-        "required": [
-          "name"
         ]
       }
     },
@@ -1244,57 +1241,54 @@
     },
     "TeamSettings": {
       "description": "A team entry",
-      "type": "object",
-      "properties": {
-        "name": {
-          "type": "string",
-          "description": "The name of the team."
-        },
-        "description": {
-          "type": "string",
-          "description": "The description of the team."
-        },
-        "maintainers": {
-          "type": "array",
-          "description": "List GitHub usernames for organization members who will become team maintainers.",
-          "items": {
-            "type": "string"
+      "allOf": [
+        {
+          "type": "object",
+          "properties": {
+            "permission": {
+              "type": "string",
+              "description": "The permission to grant the team on this repository. We accept the following permissions to be set: `pull`, `triage`, `push`, `maintain`, `admin` and you can also specify a custom repository role name, if the owning organization has defined any. If no permission is specified, the team's `permission` attribute will be used to determine what permission to grant the team on this repository."
+            }
           }
         },
-        "repo_names": {
-          "type": "array",
-          "description": "The full name (e.g., \"organization-name/repository-name\") of repositories to add the team to.",
-          "items": {
-            "type": "string"
+        {
+          "type": "object",
+          "required": [
+            "name"
+          ],
+          "properties": {
+            "name": {
+              "description": "The name (or slug) of the team to grant access to the repo.",
+              "type": "string"
+            },
+            "privacy": {
+              "description": "The level of privacy the team should have when it is created by safe-settings. The options are `secret` (visible only to organization owners and members of the team) or `closed` (visible to all members of the organization).",
+              "type": "string",
+              "enum": [
+                "secret",
+                "closed"
+              ]
+            },
+            "external_group": {
+              "description": "The display name of an external IdP group to link to this team.",
+              "type": "string"
+            },
+            "exclude": {
+              "description": "Exclude this team from repos whose names match one of these glob patterns.",
+              "type": "array",
+              "items": {
+                "type": "string"
+              }
+            },
+            "include": {
+              "description": "Apply this team only to repos whose names match one of these glob patterns.",
+              "type": "array",
+              "items": {
+                "type": "string"
+              }
+            }
           }
-        },
-        "privacy": {
-          "type": "string",
-          "description": "The level of privacy this team should have. The options are:  \n**For a non-nested team:**  \n * `secret` - only visible to organization owners and members of this team.  \n * `closed` - visible to all members of this organization.  \nDefault: `secret`  \n**For a parent or child team:**  \n * `closed` - visible to all members of this organization.  \nDefault for child team: `closed`",
-          "enum": [
-            "secret",
-            "closed"
-          ]
-        },
-        "notification_setting": {
-          "type": "string",
-          "description": "The notification setting the team has chosen. The options are:  \n * `notifications_enabled` - team members receive notifications when the team is @mentioned.  \n * `notifications_disabled` - no one receives notifications.  \nDefault: `notifications_enabled`",
-          "enum": [
-            "notifications_enabled",
-            "notifications_disabled"
-          ]
-        },
-        "parent_team_id": {
-          "type": "integer",
-          "description": "The ID of a team to set as the parent team."
-        },
-        "parent_team_slug": {
-          "type": "string",
-          "description": "The slug of a team to set as the parent team. Ignored when `parent_team_id` is also provided."
         }
-      },
-      "required": [
-        "name"
       ]
     },
     "MilestoneSettings": {
diff --git a/schema/dereferenced/suborgs.json b/schema/dereferenced/suborgs.json
index 6e7bb325..b75780ff 100644
--- a/schema/dereferenced/suborgs.json
+++ b/schema/dereferenced/suborgs.json
@@ -447,57 +447,54 @@
       "type": "array",
       "items": {
         "description": "A team entry",
-        "type": "object",
-        "properties": {
-          "name": {
-            "type": "string",
-            "description": "The name of the team."
-          },
-          "description": {
-            "type": "string",
-            "description": "The description of the team."
-          },
-          "maintainers": {
-            "type": "array",
-            "description": "List GitHub usernames for organization members who will become team maintainers.",
-            "items": {
-              "type": "string"
+        "allOf": [
+          {
+            "type": "object",
+            "properties": {
+              "permission": {
+                "type": "string",
+                "description": "The permission to grant the team on this repository. We accept the following permissions to be set: `pull`, `triage`, `push`, `maintain`, `admin` and you can also specify a custom repository role name, if the owning organization has defined any. If no permission is specified, the team's `permission` attribute will be used to determine what permission to grant the team on this repository."
+              }
             }
           },
-          "repo_names": {
-            "type": "array",
-            "description": "The full name (e.g., \"organization-name/repository-name\") of repositories to add the team to.",
-            "items": {
-              "type": "string"
+          {
+            "type": "object",
+            "required": [
+              "name"
+            ],
+            "properties": {
+              "name": {
+                "description": "The name (or slug) of the team to grant access to the repo.",
+                "type": "string"
+              },
+              "privacy": {
+                "description": "The level of privacy the team should have when it is created by safe-settings. The options are `secret` (visible only to organization owners and members of the team) or `closed` (visible to all members of the organization).",
+                "type": "string",
+                "enum": [
+                  "secret",
+                  "closed"
+                ]
+              },
+              "external_group": {
+                "description": "The display name of an external IdP group to link to this team.",
+                "type": "string"
+              },
+              "exclude": {
+                "description": "Exclude this team from repos whose names match one of these glob patterns.",
+                "type": "array",
+                "items": {
+                  "type": "string"
+                }
+              },
+              "include": {
+                "description": "Apply this team only to repos whose names match one of these glob patterns.",
+                "type": "array",
+                "items": {
+                  "type": "string"
+                }
+              }
             }
-          },
-          "privacy": {
-            "type": "string",
-            "description": "The level of privacy this team should have. The options are:  \n**For a non-nested team:**  \n * `secret` - only visible to organization owners and members of this team.  \n * `closed` - visible to all members of this organization.  \nDefault: `secret`  \n**For a parent or child team:**  \n * `closed` - visible to all members of this organization.  \nDefault for child team: `closed`",
-            "enum": [
-              "secret",
-              "closed"
-            ]
-          },
-          "notification_setting": {
-            "type": "string",
-            "description": "The notification setting the team has chosen. The options are:  \n * `notifications_enabled` - team members receive notifications when the team is @mentioned.  \n * `notifications_disabled` - no one receives notifications.  \nDefault: `notifications_enabled`",
-            "enum": [
-              "notifications_enabled",
-              "notifications_disabled"
-            ]
-          },
-          "parent_team_id": {
-            "type": "integer",
-            "description": "The ID of a team to set as the parent team."
-          },
-          "parent_team_slug": {
-            "type": "string",
-            "description": "The slug of a team to set as the parent team. Ignored when `parent_team_id` is also provided."
           }
-        },
-        "required": [
-          "name"
         ]
       }
     },
@@ -1278,57 +1275,54 @@
     },
     "TeamSettings": {
       "description": "A team entry",
-      "type": "object",
-      "properties": {
-        "name": {
-          "type": "string",
-          "description": "The name of the team."
-        },
-        "description": {
-          "type": "string",
-          "description": "The description of the team."
-        },
-        "maintainers": {
-          "type": "array",
-          "description": "List GitHub usernames for organization members who will become team maintainers.",
-          "items": {
-            "type": "string"
+      "allOf": [
+        {
+          "type": "object",
+          "properties": {
+            "permission": {
+              "type": "string",
+              "description": "The permission to grant the team on this repository. We accept the following permissions to be set: `pull`, `triage`, `push`, `maintain`, `admin` and you can also specify a custom repository role name, if the owning organization has defined any. If no permission is specified, the team's `permission` attribute will be used to determine what permission to grant the team on this repository."
+            }
           }
         },
-        "repo_names": {
-          "type": "array",
-          "description": "The full name (e.g., \"organization-name/repository-name\") of repositories to add the team to.",
-          "items": {
-            "type": "string"
+        {
+          "type": "object",
+          "required": [
+            "name"
+          ],
+          "properties": {
+            "name": {
+              "description": "The name (or slug) of the team to grant access to the repo.",
+              "type": "string"
+            },
+            "privacy": {
+              "description": "The level of privacy the team should have when it is created by safe-settings. The options are `secret` (visible only to organization owners and members of the team) or `closed` (visible to all members of the organization).",
+              "type": "string",
+              "enum": [
+                "secret",
+                "closed"
+              ]
+            },
+            "external_group": {
+              "description": "The display name of an external IdP group to link to this team.",
+              "type": "string"
+            },
+            "exclude": {
+              "description": "Exclude this team from repos whose names match one of these glob patterns.",
+              "type": "array",
+              "items": {
+                "type": "string"
+              }
+            },
+            "include": {
+              "description": "Apply this team only to repos whose names match one of these glob patterns.",
+              "type": "array",
+              "items": {
+                "type": "string"
+              }
+            }
           }
-        },
-        "privacy": {
-          "type": "string",
-          "description": "The level of privacy this team should have. The options are:  \n**For a non-nested team:**  \n * `secret` - only visible to organization owners and members of this team.  \n * `closed` - visible to all members of this organization.  \nDefault: `secret`  \n**For a parent or child team:**  \n * `closed` - visible to all members of this organization.  \nDefault for child team: `closed`",
-          "enum": [
-            "secret",
-            "closed"
-          ]
-        },
-        "notification_setting": {
-          "type": "string",
-          "description": "The notification setting the team has chosen. The options are:  \n * `notifications_enabled` - team members receive notifications when the team is @mentioned.  \n * `notifications_disabled` - no one receives notifications.  \nDefault: `notifications_enabled`",
-          "enum": [
-            "notifications_enabled",
-            "notifications_disabled"
-          ]
-        },
-        "parent_team_id": {
-          "type": "integer",
-          "description": "The ID of a team to set as the parent team."
-        },
-        "parent_team_slug": {
-          "type": "string",
-          "description": "The slug of a team to set as the parent team. Ignored when `parent_team_id` is also provided."
         }
-      },
-      "required": [
-        "name"
       ]
     },
     "MilestoneSettings": {
diff --git a/schema/repos.json b/schema/repos.json
index 3a7c5130..9db88ce5 100644
--- a/schema/repos.json
+++ b/schema/repos.json
@@ -190,7 +190,49 @@
     },
     "TeamSettings": {
       "description": "A team entry",
-      "$ref": "https://raw.githubusercontent.com/github/rest-api-description/main/descriptions/api.github.com/api.github.com.2026-03-10.json#/paths/~1orgs~1{org}~1teams/post/requestBody/content/application~1json/schema"
+      "allOf": [
+        {
+          "$ref": "https://raw.githubusercontent.com/github/rest-api-description/main/descriptions/api.github.com/api.github.com.2026-03-10.json#/paths/~1orgs~1{org}~1teams~1{team_slug}~1repos~1{owner}~1{repo}/put/requestBody/content/application~1json/schema"
+        },
+        {
+          "type": "object",
+          "required": [
+            "name"
+          ],
+          "properties": {
+            "name": {
+              "description": "The name (or slug) of the team to grant access to the repo.",
+              "type": "string"
+            },
+            "privacy": {
+              "description": "The level of privacy the team should have when it is created by safe-settings. The options are `secret` (visible only to organization owners and members of the team) or `closed` (visible to all members of the organization).",
+              "type": "string",
+              "enum": [
+                "secret",
+                "closed"
+              ]
+            },
+            "external_group": {
+              "description": "The display name of an external IdP group to link to this team.",
+              "type": "string"
+            },
+            "exclude": {
+              "description": "Exclude this team from repos whose names match one of these glob patterns.",
+              "type": "array",
+              "items": {
+                "type": "string"
+              }
+            },
+            "include": {
+              "description": "Apply this team only to repos whose names match one of these glob patterns.",
+              "type": "array",
+              "items": {
+                "type": "string"
+              }
+            }
+          }
+        }
+      ]
     },
     "MilestoneSettings": {
       "description": "A milestone entry",
diff --git a/schema/suborgs.json b/schema/suborgs.json
index 3a3c79de..241d9839 100644
--- a/schema/suborgs.json
+++ b/schema/suborgs.json
@@ -224,7 +224,49 @@
     },
     "TeamSettings": {
       "description": "A team entry",
-      "$ref": "https://raw.githubusercontent.com/github/rest-api-description/main/descriptions/api.github.com/api.github.com.2026-03-10.json#/paths/~1orgs~1{org}~1teams/post/requestBody/content/application~1json/schema"
+      "allOf": [
+        {
+          "$ref": "https://raw.githubusercontent.com/github/rest-api-description/main/descriptions/api.github.com/api.github.com.2026-03-10.json#/paths/~1orgs~1{org}~1teams~1{team_slug}~1repos~1{owner}~1{repo}/put/requestBody/content/application~1json/schema"
+        },
+        {
+          "type": "object",
+          "required": [
+            "name"
+          ],
+          "properties": {
+            "name": {
+              "description": "The name (or slug) of the team to grant access to the repo.",
+              "type": "string"
+            },
+            "privacy": {
+              "description": "The level of privacy the team should have when it is created by safe-settings. The options are `secret` (visible only to organization owners and members of the team) or `closed` (visible to all members of the organization).",
+              "type": "string",
+              "enum": [
+                "secret",
+                "closed"
+              ]
+            },
+            "external_group": {
+              "description": "The display name of an external IdP group to link to this team.",
+              "type": "string"
+            },
+            "exclude": {
+              "description": "Exclude this team from repos whose names match one of these glob patterns.",
+              "type": "array",
+              "items": {
+                "type": "string"
+              }
+            },
+            "include": {
+              "description": "Apply this team only to repos whose names match one of these glob patterns.",
+              "type": "array",
+              "items": {
+                "type": "string"
+              }
+            }
+          }
+        }
+      ]
     },
     "MilestoneSettings": {
       "description": "A milestone entry",