naftiko: 1.0.0-alpha2 info: label: GitHub Teams API — Teams description: 'GitHub Teams API — Teams. 60 operations. Lead operation: GitHub Update Ldap Mapping for Team. Self-contained Naftiko capability covering one Github business surface.' tags: - Github - Teams created: '2026-05-19' modified: '2026-05-19' binds: - namespace: env keys: GITHUB_API_KEY: GITHUB_API_KEY capability: consumes: - type: http namespace: teams-teams baseUri: '' description: GitHub Teams API — Teams business capability. Self-contained, no shared references. resources: - name: admin-ldap-teams-team_id-mapping path: /admin/ldap/teams/{team_id}/mapping operations: - name: updateldapmappingforteam method: PATCH description: GitHub Update Ldap Mapping for Team outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: body in: body type: object description: Request body (JSON). required: true - name: admin-ldap-teams-team_id-sync path: /admin/ldap/teams/{team_id}/sync operations: - name: syncldapmappingforteam method: POST description: GitHub Sync Ldap Mapping for Team outputRawFormat: json outputParameters: - name: result type: object value: $. - name: orgs-org-security-managers-teams-team_slug path: /orgs/{org}/security-managers/teams/{team_slug} operations: - name: addsecuritymanagerteam method: PUT description: GitHub Add Security Manager Team outputRawFormat: json outputParameters: - name: result type: object value: $. - name: removesecuritymanagerteam method: DELETE description: GitHub Remove Security Manager Team outputRawFormat: json outputParameters: - name: result type: object value: $. - name: orgs-org-teams path: /orgs/{org}/teams operations: - name: listteams method: GET description: GitHub List Teams outputRawFormat: json outputParameters: - name: result type: object value: $. - name: createteam method: POST description: GitHub Create Team outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: body in: body type: object description: Request body (JSON). required: true - name: orgs-org-teams-team_slug path: /orgs/{org}/teams/{team_slug} operations: - name: getteambyname method: GET description: GitHub Get Team by Name outputRawFormat: json outputParameters: - name: result type: object value: $. - name: updateteam method: PATCH description: GitHub Update Team outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: body in: body type: object description: Request body (JSON). required: false - name: deleteteam method: DELETE description: GitHub Delete Team outputRawFormat: json outputParameters: - name: result type: object value: $. - name: orgs-org-teams-team_slug-discussions-discussion_number-comments-comment_number-r path: /orgs/{org}/teams/{team_slug}/discussions/{discussion_number}/comments/{comment_number}/reactions operations: - name: listreactionsforteamdiscussioncomment method: GET description: GitHub List Reactions for Team Discussion Comment outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: content in: query type: string description: Returns a single [reaction type](https://docs.github.com/enterprise-server@3.9/rest/reactions/reactions#about-reactions). Omit this parameter to list all reacti - name: createreactionforteamdiscussioncomment method: POST description: GitHub Create Reaction for Team Discussion Comment outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: body in: body type: object description: Request body (JSON). required: true - name: orgs-org-teams-team_slug-discussions-discussion_number-comments-comment_number-r path: /orgs/{org}/teams/{team_slug}/discussions/{discussion_number}/comments/{comment_number}/reactions/{reaction_id} operations: - name: deleteteamdiscussioncommentreaction method: DELETE description: GitHub Delete Team Discussion Comment Reaction outputRawFormat: json outputParameters: - name: result type: object value: $. - name: orgs-org-teams-team_slug-discussions-discussion_number-reactions path: /orgs/{org}/teams/{team_slug}/discussions/{discussion_number}/reactions operations: - name: listreactionsforteamdiscussion method: GET description: GitHub List Reactions for Team Discussion outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: content in: query type: string description: Returns a single [reaction type](https://docs.github.com/enterprise-server@3.9/rest/reactions/reactions#about-reactions). Omit this parameter to list all reacti - name: createreactionforteamdiscussion method: POST description: GitHub Create Reaction for Team Discussion outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: body in: body type: object description: Request body (JSON). required: true - name: orgs-org-teams-team_slug-discussions-discussion_number-reactions-reaction_id path: /orgs/{org}/teams/{team_slug}/discussions/{discussion_number}/reactions/{reaction_id} operations: - name: deleteteamdiscussionreaction method: DELETE description: GitHub Delete Team Discussion Reaction outputRawFormat: json outputParameters: - name: result type: object value: $. - name: orgs-org-teams-team_slug-external-groups path: /orgs/{org}/teams/{team_slug}/external-groups operations: - name: listconnectionbetweenanexternalgroupandteam method: GET description: GitHub List Connection Between an External Group and Team outputRawFormat: json outputParameters: - name: result type: object value: $. - name: updatetheconnectionbetweenanexternalgroupandteam method: PATCH description: GitHub Update the Connection Between an External Group and Team outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: body in: body type: object description: Request body (JSON). required: true - name: removetheconnectionbetweenanexternalgroupandteam method: DELETE description: GitHub Remove the Connection Between an External Group and Team outputRawFormat: json outputParameters: - name: result type: object value: $. - name: orgs-org-teams-team_slug-members path: /orgs/{org}/teams/{team_slug}/members operations: - name: listteammembers method: GET description: GitHub List Team Members outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: role in: query type: string description: Filters members returned by their role in the team. - name: orgs-org-teams-team_slug-memberships-username path: /orgs/{org}/teams/{team_slug}/memberships/{username} operations: - name: getteammembershipforuser method: GET description: GitHub Get Team Membership for User outputRawFormat: json outputParameters: - name: result type: object value: $. - name: addorupdateteammembershipforuser method: PUT description: GitHub Add or Update Team Membership for User outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: body in: body type: object description: Request body (JSON). required: false - name: removeteammembershipforuser method: DELETE description: GitHub Remove Team Membership for User outputRawFormat: json outputParameters: - name: result type: object value: $. - name: orgs-org-teams-team_slug-projects path: /orgs/{org}/teams/{team_slug}/projects operations: - name: listteamprojects method: GET description: GitHub List Team Projects outputRawFormat: json outputParameters: - name: result type: object value: $. - name: orgs-org-teams-team_slug-projects-project_id path: /orgs/{org}/teams/{team_slug}/projects/{project_id} operations: - name: checkteampermissionsforproject method: GET description: GitHub Check Team Permissions for Project outputRawFormat: json outputParameters: - name: result type: object value: $. - name: addorupdateteamprojectpermissions method: PUT description: GitHub Add or Update Team Project Permissions outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: body in: body type: object description: Request body (JSON). required: false - name: removeprojectfromteam method: DELETE description: GitHub Remove Project from Team outputRawFormat: json outputParameters: - name: result type: object value: $. - name: orgs-org-teams-team_slug-repos path: /orgs/{org}/teams/{team_slug}/repos operations: - name: listteamrepositories method: GET description: GitHub List Team Repositories outputRawFormat: json outputParameters: - name: result type: object value: $. - name: orgs-org-teams-team_slug-repos-owner-repo path: /orgs/{org}/teams/{team_slug}/repos/{owner}/{repo} operations: - name: checkteampermissionsforrepository method: GET description: GitHub Check Team Permissions for Repository outputRawFormat: json outputParameters: - name: result type: object value: $. - name: addorupdateteamrepositorypermissions method: PUT description: GitHub Add or Update Team Repository Permissions outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: body in: body type: object description: Request body (JSON). required: false - name: removerepositoryfromteam method: DELETE description: GitHub Remove Repository from Team outputRawFormat: json outputParameters: - name: result type: object value: $. - name: orgs-org-teams-team_slug-teams path: /orgs/{org}/teams/{team_slug}/teams operations: - name: listchildteams method: GET description: GitHub List Child Teams outputRawFormat: json outputParameters: - name: result type: object value: $. - name: repos-owner-repo-branches-branch-protection-restrictions-teams path: /repos/{owner}/{repo}/branches/{branch}/protection/restrictions/teams operations: - name: getteamswithaccesstotheprotectedbranch method: GET description: GitHub Get Teams with Access to the Protected Branch outputRawFormat: json outputParameters: - name: result type: object value: $. - name: addteamaccessrestrictions method: POST description: GitHub Add Team Access Restrictions outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: body in: body type: object description: Request body (JSON). required: false - name: setteamaccessrestrictions method: PUT description: GitHub Set Team Access Restrictions outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: body in: body type: object description: Request body (JSON). required: false - name: removeteamaccessrestrictions method: DELETE description: GitHub Remove Team Access Restrictions outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: body in: body type: object description: Request body (JSON). required: false - name: repos-owner-repo-teams path: /repos/{owner}/{repo}/teams operations: - name: listrepositoryteams method: GET description: GitHub List Repository Teams outputRawFormat: json outputParameters: - name: result type: object value: $. - name: teams-team_id path: /teams/{team_id} operations: - name: getteamlegacy method: GET description: GitHub Get Team (legacy) outputRawFormat: json outputParameters: - name: result type: object value: $. - name: updateteamlegacy method: PATCH description: GitHub Update Team (legacy) outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: body in: body type: object description: Request body (JSON). required: true - name: deleteteamlegacy method: DELETE description: GitHub Delete Team (legacy) outputRawFormat: json outputParameters: - name: result type: object value: $. - name: teams-team_id-discussions-discussion_number-comments-comment_number-reactions path: /teams/{team_id}/discussions/{discussion_number}/comments/{comment_number}/reactions operations: - name: listreactionsforteamdiscussioncommentlegacy method: GET description: GitHub List Reactions for Team Discussion Comment (legacy) outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: content in: query type: string description: Returns a single [reaction type](https://docs.github.com/enterprise-server@3.9/rest/reactions/reactions#about-reactions). Omit this parameter to list all reacti - name: createreactionforteamdiscussioncommentlegacy method: POST description: GitHub Create Reaction for Team Discussion Comment (legacy) outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: body in: body type: object description: Request body (JSON). required: true - name: teams-team_id-discussions-discussion_number-reactions path: /teams/{team_id}/discussions/{discussion_number}/reactions operations: - name: listreactionsforteamdiscussionlegacy method: GET description: GitHub List Reactions for Team Discussion (legacy) outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: content in: query type: string description: Returns a single [reaction type](https://docs.github.com/enterprise-server@3.9/rest/reactions/reactions#about-reactions). Omit this parameter to list all reacti - name: createreactionforteamdiscussionlegacy method: POST description: GitHub Create Reaction for Team Discussion (legacy) outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: body in: body type: object description: Request body (JSON). required: true - name: teams-team_id-members path: /teams/{team_id}/members operations: - name: listteammemberslegacy method: GET description: GitHub List Team Members (legacy) outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: role in: query type: string description: Filters members returned by their role in the team. - name: teams-team_id-members-username path: /teams/{team_id}/members/{username} operations: - name: getteammemberlegacy method: GET description: GitHub Get Team Member (legacy) outputRawFormat: json outputParameters: - name: result type: object value: $. - name: addteammemberlegacy method: PUT description: GitHub Add Team Member (legacy) outputRawFormat: json outputParameters: - name: result type: object value: $. - name: removeteammemberlegacy method: DELETE description: GitHub Remove Team Member (legacy) outputRawFormat: json outputParameters: - name: result type: object value: $. - name: teams-team_id-memberships-username path: /teams/{team_id}/memberships/{username} operations: - name: getteammembershipforuserlegacy method: GET description: GitHub Get Team Membership for User (legacy) outputRawFormat: json outputParameters: - name: result type: object value: $. - name: addorupdateteammembershipforuserlegacy method: PUT description: GitHub Add or Update Team Membership for User (legacy) outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: body in: body type: object description: Request body (JSON). required: false - name: removeteammembershipforuserlegacy method: DELETE description: GitHub Remove Team Membership for User (legacy) outputRawFormat: json outputParameters: - name: result type: object value: $. - name: teams-team_id-projects path: /teams/{team_id}/projects operations: - name: listteamprojectslegacy method: GET description: GitHub List Team Projects (legacy) outputRawFormat: json outputParameters: - name: result type: object value: $. - name: teams-team_id-projects-project_id path: /teams/{team_id}/projects/{project_id} operations: - name: checkteampermissionsforprojectlegacy method: GET description: GitHub Check Team Permissions for Project (legacy) outputRawFormat: json outputParameters: - name: result type: object value: $. - name: addorupdateteamprojectpermissionslegacy method: PUT description: GitHub Add or Update Team Project Permissions (legacy) outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: body in: body type: object description: Request body (JSON). required: false - name: removeprojectfromteamlegacy method: DELETE description: GitHub Remove Project from Team (legacy) outputRawFormat: json outputParameters: - name: result type: object value: $. - name: teams-team_id-repos path: /teams/{team_id}/repos operations: - name: listteamrepositorieslegacy method: GET description: GitHub List Team Repositories (legacy) outputRawFormat: json outputParameters: - name: result type: object value: $. - name: teams-team_id-repos-owner-repo path: /teams/{team_id}/repos/{owner}/{repo} operations: - name: checkteampermissionsforrepositorylegacy method: GET description: GitHub Check Team Permissions for Repository (legacy) outputRawFormat: json outputParameters: - name: result type: object value: $. - name: addorupdateteamrepositorypermissionslegacy method: PUT description: GitHub Add or Update Team Repository Permissions (legacy) outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: body in: body type: object description: Request body (JSON). required: false - name: removerepositoryfromteamlegacy method: DELETE description: GitHub Remove Repository from Team (legacy) outputRawFormat: json outputParameters: - name: result type: object value: $. - name: teams-team_id-teams path: /teams/{team_id}/teams operations: - name: listchildteamslegacy method: GET description: GitHub List Child Teams (legacy) outputRawFormat: json outputParameters: - name: result type: object value: $. - name: user-teams path: /user/teams operations: - name: listteamsfortheauthenticateduser method: GET description: GitHub List Teams for the Authenticated User outputRawFormat: json outputParameters: - name: result type: object value: $. authentication: type: bearer token: '{{env.GITHUB_API_KEY}}' exposes: - type: rest namespace: teams-teams-rest port: 8080 description: REST adapter for GitHub Teams API — Teams. One Spectral-compliant resource per consumed operation, prefixed with /v1. resources: - path: /v1/admin/ldap/teams/{team-id}/mapping name: admin-ldap-teams-team-id-mapping description: REST surface for admin-ldap-teams-team_id-mapping. operations: - method: PATCH name: updateldapmappingforteam description: GitHub Update Ldap Mapping for Team call: teams-teams.updateldapmappingforteam with: body: rest.body outputParameters: - type: object mapping: $. - path: /v1/admin/ldap/teams/{team-id}/sync name: admin-ldap-teams-team-id-sync description: REST surface for admin-ldap-teams-team_id-sync. operations: - method: POST name: syncldapmappingforteam description: GitHub Sync Ldap Mapping for Team call: teams-teams.syncldapmappingforteam outputParameters: - type: object mapping: $. - path: /v1/orgs/{org}/security-managers/teams/{team-slug} name: orgs-org-security-managers-teams-team-slug description: REST surface for orgs-org-security-managers-teams-team_slug. operations: - method: PUT name: addsecuritymanagerteam description: GitHub Add Security Manager Team call: teams-teams.addsecuritymanagerteam outputParameters: - type: object mapping: $. - method: DELETE name: removesecuritymanagerteam description: GitHub Remove Security Manager Team call: teams-teams.removesecuritymanagerteam outputParameters: - type: object mapping: $. - path: /v1/orgs/{org}/teams name: orgs-org-teams description: REST surface for orgs-org-teams. operations: - method: GET name: listteams description: GitHub List Teams call: teams-teams.listteams outputParameters: - type: object mapping: $. - method: POST name: createteam description: GitHub Create Team call: teams-teams.createteam with: body: rest.body outputParameters: - type: object mapping: $. - path: /v1/orgs/{org}/teams/{team-slug} name: orgs-org-teams-team-slug description: REST surface for orgs-org-teams-team_slug. operations: - method: GET name: getteambyname description: GitHub Get Team by Name call: teams-teams.getteambyname outputParameters: - type: object mapping: $. - method: PATCH name: updateteam description: GitHub Update Team call: teams-teams.updateteam with: body: rest.body outputParameters: - type: object mapping: $. - method: DELETE name: deleteteam description: GitHub Delete Team call: teams-teams.deleteteam outputParameters: - type: object mapping: $. - path: /v1/orgs/{org}/teams/{team-slug}/discussions/{discussion-number}/comments/{comment-number}/reactions name: orgs-org-teams-team-slug-discussions-discussion-number-comments-comment-number-r description: REST surface for orgs-org-teams-team_slug-discussions-discussion_number-comments-comment_number-r. operations: - method: GET name: listreactionsforteamdiscussioncomment description: GitHub List Reactions for Team Discussion Comment call: teams-teams.listreactionsforteamdiscussioncomment with: content: rest.content outputParameters: - type: object mapping: $. - method: POST name: createreactionforteamdiscussioncomment description: GitHub Create Reaction for Team Discussion Comment call: teams-teams.createreactionforteamdiscussioncomment with: body: rest.body outputParameters: - type: object mapping: $. - path: /v1/orgs/{org}/teams/{team-slug}/discussions/{discussion-number}/comments/{comment-number}/reactions/{reaction-id} name: orgs-org-teams-team-slug-discussions-discussion-number-comments-comment-number-r description: REST surface for orgs-org-teams-team_slug-discussions-discussion_number-comments-comment_number-r. operations: - method: DELETE name: deleteteamdiscussioncommentreaction description: GitHub Delete Team Discussion Comment Reaction call: teams-teams.deleteteamdiscussioncommentreaction outputParameters: - type: object mapping: $. - path: /v1/orgs/{org}/teams/{team-slug}/discussions/{discussion-number}/reactions name: orgs-org-teams-team-slug-discussions-discussion-number-reactions description: REST surface for orgs-org-teams-team_slug-discussions-discussion_number-reactions. operations: - method: GET name: listreactionsforteamdiscussion description: GitHub List Reactions for Team Discussion call: teams-teams.listreactionsforteamdiscussion with: content: rest.content outputParameters: - type: object mapping: $. - method: POST name: createreactionforteamdiscussion description: GitHub Create Reaction for Team Discussion call: teams-teams.createreactionforteamdiscussion with: body: rest.body outputParameters: - type: object mapping: $. - path: /v1/orgs/{org}/teams/{team-slug}/discussions/{discussion-number}/reactions/{reaction-id} name: orgs-org-teams-team-slug-discussions-discussion-number-reactions-reaction-id description: REST surface for orgs-org-teams-team_slug-discussions-discussion_number-reactions-reaction_id. operations: - method: DELETE name: deleteteamdiscussionreaction description: GitHub Delete Team Discussion Reaction call: teams-teams.deleteteamdiscussionreaction outputParameters: - type: object mapping: $. - path: /v1/orgs/{org}/teams/{team-slug}/external-groups name: orgs-org-teams-team-slug-external-groups description: REST surface for orgs-org-teams-team_slug-external-groups. operations: - method: GET name: listconnectionbetweenanexternalgroupandteam description: GitHub List Connection Between an External Group and Team call: teams-teams.listconnectionbetweenanexternalgroupandteam outputParameters: - type: object mapping: $. - method: PATCH name: updatetheconnectionbetweenanexternalgroupandteam description: GitHub Update the Connection Between an External Group and Team call: teams-teams.updatetheconnectionbetweenanexternalgroupandteam with: body: rest.body outputParameters: - type: object mapping: $. - method: DELETE name: removetheconnectionbetweenanexternalgroupandteam description: GitHub Remove the Connection Between an External Group and Team call: teams-teams.removetheconnectionbetweenanexternalgroupandteam outputParameters: - type: object mapping: $. - path: /v1/orgs/{org}/teams/{team-slug}/members name: orgs-org-teams-team-slug-members description: REST surface for orgs-org-teams-team_slug-members. operations: - method: GET name: listteammembers description: GitHub List Team Members call: teams-teams.listteammembers with: role: rest.role outputParameters: - type: object mapping: $. - path: /v1/orgs/{org}/teams/{team-slug}/memberships/{username} name: orgs-org-teams-team-slug-memberships-username description: REST surface for orgs-org-teams-team_slug-memberships-username. operations: - method: GET name: getteammembershipforuser description: GitHub Get Team Membership for User call: teams-teams.getteammembershipforuser outputParameters: - type: object mapping: $. - method: PUT name: addorupdateteammembershipforuser description: GitHub Add or Update Team Membership for User call: teams-teams.addorupdateteammembershipforuser with: body: rest.body outputParameters: - type: object mapping: $. - method: DELETE name: removeteammembershipforuser description: GitHub Remove Team Membership for User call: teams-teams.removeteammembershipforuser outputParameters: - type: object mapping: $. - path: /v1/orgs/{org}/teams/{team-slug}/projects name: orgs-org-teams-team-slug-projects description: REST surface for orgs-org-teams-team_slug-projects. operations: - method: GET name: listteamprojects description: GitHub List Team Projects call: teams-teams.listteamprojects outputParameters: - type: object mapping: $. - path: /v1/orgs/{org}/teams/{team-slug}/projects/{project-id} name: orgs-org-teams-team-slug-projects-project-id description: REST surface for orgs-org-teams-team_slug-projects-project_id. operations: - method: GET name: checkteampermissionsforproject description: GitHub Check Team Permissions for Project call: teams-teams.checkteampermissionsforproject outputParameters: - type: object mapping: $. - method: PUT name: addorupdateteamprojectpermissions description: GitHub Add or Update Team Project Permissions call: teams-teams.addorupdateteamprojectpermissions with: body: rest.body outputParameters: - type: object mapping: $. - method: DELETE name: removeprojectfromteam description: GitHub Remove Project from Team call: teams-teams.removeprojectfromteam outputParameters: - type: object mapping: $. - path: /v1/orgs/{org}/teams/{team-slug}/repos name: orgs-org-teams-team-slug-repos description: REST surface for orgs-org-teams-team_slug-repos. operations: - method: GET name: listteamrepositories description: GitHub List Team Repositories call: teams-teams.listteamrepositories outputParameters: - type: object mapping: $. - path: /v1/orgs/{org}/teams/{team-slug}/repos/{owner}/{repo} name: orgs-org-teams-team-slug-repos-owner-repo description: REST surface for orgs-org-teams-team_slug-repos-owner-repo. operations: - method: GET name: checkteampermissionsforrepository description: GitHub Check Team Permissions for Repository call: teams-teams.checkteampermissionsforrepository outputParameters: - type: object mapping: $. - method: PUT name: addorupdateteamrepositorypermissions description: GitHub Add or Update Team Repository Permissions call: teams-teams.addorupdateteamrepositorypermissions with: body: rest.body outputParameters: - type: object mapping: $. - method: DELETE name: removerepositoryfromteam description: GitHub Remove Repository from Team call: teams-teams.removerepositoryfromteam outputParameters: - type: object mapping: $. - path: /v1/orgs/{org}/teams/{team-slug}/teams name: orgs-org-teams-team-slug-teams description: REST surface for orgs-org-teams-team_slug-teams. operations: - method: GET name: listchildteams description: GitHub List Child Teams call: teams-teams.listchildteams outputParameters: - type: object mapping: $. - path: /v1/repos/{owner}/{repo}/branches/{branch}/protection/restrictions/teams name: repos-owner-repo-branches-branch-protection-restrictions-teams description: REST surface for repos-owner-repo-branches-branch-protection-restrictions-teams. operations: - method: GET name: getteamswithaccesstotheprotectedbranch description: GitHub Get Teams with Access to the Protected Branch call: teams-teams.getteamswithaccesstotheprotectedbranch outputParameters: - type: object mapping: $. - method: POST name: addteamaccessrestrictions description: GitHub Add Team Access Restrictions call: teams-teams.addteamaccessrestrictions with: body: rest.body outputParameters: - type: object mapping: $. - method: PUT name: setteamaccessrestrictions description: GitHub Set Team Access Restrictions call: teams-teams.setteamaccessrestrictions with: body: rest.body outputParameters: - type: object mapping: $. - method: DELETE name: removeteamaccessrestrictions description: GitHub Remove Team Access Restrictions call: teams-teams.removeteamaccessrestrictions with: body: rest.body outputParameters: - type: object mapping: $. - path: /v1/repos/{owner}/{repo}/teams name: repos-owner-repo-teams description: REST surface for repos-owner-repo-teams. operations: - method: GET name: listrepositoryteams description: GitHub List Repository Teams call: teams-teams.listrepositoryteams outputParameters: - type: object mapping: $. - path: /v1/teams/{team-id} name: teams-team-id description: REST surface for teams-team_id. operations: - method: GET name: getteamlegacy description: GitHub Get Team (legacy) call: teams-teams.getteamlegacy outputParameters: - type: object mapping: $. - method: PATCH name: updateteamlegacy description: GitHub Update Team (legacy) call: teams-teams.updateteamlegacy with: body: rest.body outputParameters: - type: object mapping: $. - method: DELETE name: deleteteamlegacy description: GitHub Delete Team (legacy) call: teams-teams.deleteteamlegacy outputParameters: - type: object mapping: $. - path: /v1/teams/{team-id}/discussions/{discussion-number}/comments/{comment-number}/reactions name: teams-team-id-discussions-discussion-number-comments-comment-number-reactions description: REST surface for teams-team_id-discussions-discussion_number-comments-comment_number-reactions. operations: - method: GET name: listreactionsforteamdiscussioncommentlegacy description: GitHub List Reactions for Team Discussion Comment (legacy) call: teams-teams.listreactionsforteamdiscussioncommentlegacy with: content: rest.content outputParameters: - type: object mapping: $. - method: POST name: createreactionforteamdiscussioncommentlegacy description: GitHub Create Reaction for Team Discussion Comment (legacy) call: teams-teams.createreactionforteamdiscussioncommentlegacy with: body: rest.body outputParameters: - type: object mapping: $. - path: /v1/teams/{team-id}/discussions/{discussion-number}/reactions name: teams-team-id-discussions-discussion-number-reactions description: REST surface for teams-team_id-discussions-discussion_number-reactions. operations: - method: GET name: listreactionsforteamdiscussionlegacy description: GitHub List Reactions for Team Discussion (legacy) call: teams-teams.listreactionsforteamdiscussionlegacy with: content: rest.content outputParameters: - type: object mapping: $. - method: POST name: createreactionforteamdiscussionlegacy description: GitHub Create Reaction for Team Discussion (legacy) call: teams-teams.createreactionforteamdiscussionlegacy with: body: rest.body outputParameters: - type: object mapping: $. - path: /v1/teams/{team-id}/members name: teams-team-id-members description: REST surface for teams-team_id-members. operations: - method: GET name: listteammemberslegacy description: GitHub List Team Members (legacy) call: teams-teams.listteammemberslegacy with: role: rest.role outputParameters: - type: object mapping: $. - path: /v1/teams/{team-id}/members/{username} name: teams-team-id-members-username description: REST surface for teams-team_id-members-username. operations: - method: GET name: getteammemberlegacy description: GitHub Get Team Member (legacy) call: teams-teams.getteammemberlegacy outputParameters: - type: object mapping: $. - method: PUT name: addteammemberlegacy description: GitHub Add Team Member (legacy) call: teams-teams.addteammemberlegacy outputParameters: - type: object mapping: $. - method: DELETE name: removeteammemberlegacy description: GitHub Remove Team Member (legacy) call: teams-teams.removeteammemberlegacy outputParameters: - type: object mapping: $. - path: /v1/teams/{team-id}/memberships/{username} name: teams-team-id-memberships-username description: REST surface for teams-team_id-memberships-username. operations: - method: GET name: getteammembershipforuserlegacy description: GitHub Get Team Membership for User (legacy) call: teams-teams.getteammembershipforuserlegacy outputParameters: - type: object mapping: $. - method: PUT name: addorupdateteammembershipforuserlegacy description: GitHub Add or Update Team Membership for User (legacy) call: teams-teams.addorupdateteammembershipforuserlegacy with: body: rest.body outputParameters: - type: object mapping: $. - method: DELETE name: removeteammembershipforuserlegacy description: GitHub Remove Team Membership for User (legacy) call: teams-teams.removeteammembershipforuserlegacy outputParameters: - type: object mapping: $. - path: /v1/teams/{team-id}/projects name: teams-team-id-projects description: REST surface for teams-team_id-projects. operations: - method: GET name: listteamprojectslegacy description: GitHub List Team Projects (legacy) call: teams-teams.listteamprojectslegacy outputParameters: - type: object mapping: $. - path: /v1/teams/{team-id}/projects/{project-id} name: teams-team-id-projects-project-id description: REST surface for teams-team_id-projects-project_id. operations: - method: GET name: checkteampermissionsforprojectlegacy description: GitHub Check Team Permissions for Project (legacy) call: teams-teams.checkteampermissionsforprojectlegacy outputParameters: - type: object mapping: $. - method: PUT name: addorupdateteamprojectpermissionslegacy description: GitHub Add or Update Team Project Permissions (legacy) call: teams-teams.addorupdateteamprojectpermissionslegacy with: body: rest.body outputParameters: - type: object mapping: $. - method: DELETE name: removeprojectfromteamlegacy description: GitHub Remove Project from Team (legacy) call: teams-teams.removeprojectfromteamlegacy outputParameters: - type: object mapping: $. - path: /v1/teams/{team-id}/repos name: teams-team-id-repos description: REST surface for teams-team_id-repos. operations: - method: GET name: listteamrepositorieslegacy description: GitHub List Team Repositories (legacy) call: teams-teams.listteamrepositorieslegacy outputParameters: - type: object mapping: $. - path: /v1/teams/{team-id}/repos/{owner}/{repo} name: teams-team-id-repos-owner-repo description: REST surface for teams-team_id-repos-owner-repo. operations: - method: GET name: checkteampermissionsforrepositorylegacy description: GitHub Check Team Permissions for Repository (legacy) call: teams-teams.checkteampermissionsforrepositorylegacy outputParameters: - type: object mapping: $. - method: PUT name: addorupdateteamrepositorypermissionslegacy description: GitHub Add or Update Team Repository Permissions (legacy) call: teams-teams.addorupdateteamrepositorypermissionslegacy with: body: rest.body outputParameters: - type: object mapping: $. - method: DELETE name: removerepositoryfromteamlegacy description: GitHub Remove Repository from Team (legacy) call: teams-teams.removerepositoryfromteamlegacy outputParameters: - type: object mapping: $. - path: /v1/teams/{team-id}/teams name: teams-team-id-teams description: REST surface for teams-team_id-teams. operations: - method: GET name: listchildteamslegacy description: GitHub List Child Teams (legacy) call: teams-teams.listchildteamslegacy outputParameters: - type: object mapping: $. - path: /v1/user/teams name: user-teams description: REST surface for user-teams. operations: - method: GET name: listteamsfortheauthenticateduser description: GitHub List Teams for the Authenticated User call: teams-teams.listteamsfortheauthenticateduser outputParameters: - type: object mapping: $. - type: mcp namespace: teams-teams-mcp port: 9090 transport: http description: MCP adapter for GitHub Teams API — Teams. One tool per consumed operation, routed inline through this capability's consumes block. tools: - name: github-update-ldap-mapping-team description: GitHub Update Ldap Mapping for Team hints: readOnly: false destructive: false idempotent: true call: teams-teams.updateldapmappingforteam with: body: tools.body outputParameters: - type: object mapping: $. - name: github-sync-ldap-mapping-team description: GitHub Sync Ldap Mapping for Team hints: readOnly: false destructive: false idempotent: false call: teams-teams.syncldapmappingforteam outputParameters: - type: object mapping: $. - name: github-add-security-manager-team description: GitHub Add Security Manager Team hints: readOnly: false destructive: false idempotent: true call: teams-teams.addsecuritymanagerteam outputParameters: - type: object mapping: $. - name: github-remove-security-manager-team description: GitHub Remove Security Manager Team hints: readOnly: false destructive: true idempotent: true call: teams-teams.removesecuritymanagerteam outputParameters: - type: object mapping: $. - name: github-list-teams description: GitHub List Teams hints: readOnly: true destructive: false idempotent: true call: teams-teams.listteams outputParameters: - type: object mapping: $. - name: github-create-team description: GitHub Create Team hints: readOnly: false destructive: false idempotent: false call: teams-teams.createteam with: body: tools.body outputParameters: - type: object mapping: $. - name: github-get-team-name description: GitHub Get Team by Name hints: readOnly: true destructive: false idempotent: true call: teams-teams.getteambyname outputParameters: - type: object mapping: $. - name: github-update-team description: GitHub Update Team hints: readOnly: false destructive: false idempotent: true call: teams-teams.updateteam with: body: tools.body outputParameters: - type: object mapping: $. - name: github-delete-team description: GitHub Delete Team hints: readOnly: false destructive: true idempotent: true call: teams-teams.deleteteam outputParameters: - type: object mapping: $. - name: github-list-reactions-team-discussion description: GitHub List Reactions for Team Discussion Comment hints: readOnly: true destructive: false idempotent: true call: teams-teams.listreactionsforteamdiscussioncomment with: content: tools.content outputParameters: - type: object mapping: $. - name: github-create-reaction-team-discussion description: GitHub Create Reaction for Team Discussion Comment hints: readOnly: false destructive: false idempotent: false call: teams-teams.createreactionforteamdiscussioncomment with: body: tools.body outputParameters: - type: object mapping: $. - name: github-delete-team-discussion-comment description: GitHub Delete Team Discussion Comment Reaction hints: readOnly: false destructive: true idempotent: true call: teams-teams.deleteteamdiscussioncommentreaction outputParameters: - type: object mapping: $. - name: github-list-reactions-team-discussion-2 description: GitHub List Reactions for Team Discussion hints: readOnly: true destructive: false idempotent: true call: teams-teams.listreactionsforteamdiscussion with: content: tools.content outputParameters: - type: object mapping: $. - name: github-create-reaction-team-discussion-2 description: GitHub Create Reaction for Team Discussion hints: readOnly: false destructive: false idempotent: false call: teams-teams.createreactionforteamdiscussion with: body: tools.body outputParameters: - type: object mapping: $. - name: github-delete-team-discussion-reaction description: GitHub Delete Team Discussion Reaction hints: readOnly: false destructive: true idempotent: true call: teams-teams.deleteteamdiscussionreaction outputParameters: - type: object mapping: $. - name: github-list-connection-between-external description: GitHub List Connection Between an External Group and Team hints: readOnly: true destructive: false idempotent: true call: teams-teams.listconnectionbetweenanexternalgroupandteam outputParameters: - type: object mapping: $. - name: github-update-connection-between-external description: GitHub Update the Connection Between an External Group and Team hints: readOnly: false destructive: false idempotent: true call: teams-teams.updatetheconnectionbetweenanexternalgroupandteam with: body: tools.body outputParameters: - type: object mapping: $. - name: github-remove-connection-between-external description: GitHub Remove the Connection Between an External Group and Team hints: readOnly: false destructive: true idempotent: true call: teams-teams.removetheconnectionbetweenanexternalgroupandteam outputParameters: - type: object mapping: $. - name: github-list-team-members description: GitHub List Team Members hints: readOnly: true destructive: false idempotent: true call: teams-teams.listteammembers with: role: tools.role outputParameters: - type: object mapping: $. - name: github-get-team-membership-user description: GitHub Get Team Membership for User hints: readOnly: true destructive: false idempotent: true call: teams-teams.getteammembershipforuser outputParameters: - type: object mapping: $. - name: github-add-update-team-membership description: GitHub Add or Update Team Membership for User hints: readOnly: false destructive: false idempotent: true call: teams-teams.addorupdateteammembershipforuser with: body: tools.body outputParameters: - type: object mapping: $. - name: github-remove-team-membership-user description: GitHub Remove Team Membership for User hints: readOnly: false destructive: true idempotent: true call: teams-teams.removeteammembershipforuser outputParameters: - type: object mapping: $. - name: github-list-team-projects description: GitHub List Team Projects hints: readOnly: true destructive: false idempotent: true call: teams-teams.listteamprojects outputParameters: - type: object mapping: $. - name: github-check-team-permissions-project description: GitHub Check Team Permissions for Project hints: readOnly: true destructive: false idempotent: true call: teams-teams.checkteampermissionsforproject outputParameters: - type: object mapping: $. - name: github-add-update-team-project description: GitHub Add or Update Team Project Permissions hints: readOnly: false destructive: false idempotent: true call: teams-teams.addorupdateteamprojectpermissions with: body: tools.body outputParameters: - type: object mapping: $. - name: github-remove-project-team description: GitHub Remove Project from Team hints: readOnly: false destructive: true idempotent: true call: teams-teams.removeprojectfromteam outputParameters: - type: object mapping: $. - name: github-list-team-repositories description: GitHub List Team Repositories hints: readOnly: true destructive: false idempotent: true call: teams-teams.listteamrepositories outputParameters: - type: object mapping: $. - name: github-check-team-permissions-repository description: GitHub Check Team Permissions for Repository hints: readOnly: true destructive: false idempotent: true call: teams-teams.checkteampermissionsforrepository outputParameters: - type: object mapping: $. - name: github-add-update-team-repository description: GitHub Add or Update Team Repository Permissions hints: readOnly: false destructive: false idempotent: true call: teams-teams.addorupdateteamrepositorypermissions with: body: tools.body outputParameters: - type: object mapping: $. - name: github-remove-repository-team description: GitHub Remove Repository from Team hints: readOnly: false destructive: true idempotent: true call: teams-teams.removerepositoryfromteam outputParameters: - type: object mapping: $. - name: github-list-child-teams description: GitHub List Child Teams hints: readOnly: true destructive: false idempotent: true call: teams-teams.listchildteams outputParameters: - type: object mapping: $. - name: github-get-teams-access-protected description: GitHub Get Teams with Access to the Protected Branch hints: readOnly: true destructive: false idempotent: true call: teams-teams.getteamswithaccesstotheprotectedbranch outputParameters: - type: object mapping: $. - name: github-add-team-access-restrictions description: GitHub Add Team Access Restrictions hints: readOnly: false destructive: false idempotent: false call: teams-teams.addteamaccessrestrictions with: body: tools.body outputParameters: - type: object mapping: $. - name: github-set-team-access-restrictions description: GitHub Set Team Access Restrictions hints: readOnly: false destructive: false idempotent: true call: teams-teams.setteamaccessrestrictions with: body: tools.body outputParameters: - type: object mapping: $. - name: github-remove-team-access-restrictions description: GitHub Remove Team Access Restrictions hints: readOnly: false destructive: true idempotent: true call: teams-teams.removeteamaccessrestrictions with: body: tools.body outputParameters: - type: object mapping: $. - name: github-list-repository-teams description: GitHub List Repository Teams hints: readOnly: true destructive: false idempotent: true call: teams-teams.listrepositoryteams outputParameters: - type: object mapping: $. - name: github-get-team-legacy description: GitHub Get Team (legacy) hints: readOnly: true destructive: false idempotent: true call: teams-teams.getteamlegacy outputParameters: - type: object mapping: $. - name: github-update-team-legacy description: GitHub Update Team (legacy) hints: readOnly: false destructive: false idempotent: true call: teams-teams.updateteamlegacy with: body: tools.body outputParameters: - type: object mapping: $. - name: github-delete-team-legacy description: GitHub Delete Team (legacy) hints: readOnly: false destructive: true idempotent: true call: teams-teams.deleteteamlegacy outputParameters: - type: object mapping: $. - name: github-list-reactions-team-discussion-3 description: GitHub List Reactions for Team Discussion Comment (legacy) hints: readOnly: true destructive: false idempotent: true call: teams-teams.listreactionsforteamdiscussioncommentlegacy with: content: tools.content outputParameters: - type: object mapping: $. - name: github-create-reaction-team-discussion-3 description: GitHub Create Reaction for Team Discussion Comment (legacy) hints: readOnly: false destructive: false idempotent: false call: teams-teams.createreactionforteamdiscussioncommentlegacy with: body: tools.body outputParameters: - type: object mapping: $. - name: github-list-reactions-team-discussion-4 description: GitHub List Reactions for Team Discussion (legacy) hints: readOnly: true destructive: false idempotent: true call: teams-teams.listreactionsforteamdiscussionlegacy with: content: tools.content outputParameters: - type: object mapping: $. - name: github-create-reaction-team-discussion-4 description: GitHub Create Reaction for Team Discussion (legacy) hints: readOnly: false destructive: false idempotent: false call: teams-teams.createreactionforteamdiscussionlegacy with: body: tools.body outputParameters: - type: object mapping: $. - name: github-list-team-members-legacy description: GitHub List Team Members (legacy) hints: readOnly: true destructive: false idempotent: true call: teams-teams.listteammemberslegacy with: role: tools.role outputParameters: - type: object mapping: $. - name: github-get-team-member-legacy description: GitHub Get Team Member (legacy) hints: readOnly: true destructive: false idempotent: true call: teams-teams.getteammemberlegacy outputParameters: - type: object mapping: $. - name: github-add-team-member-legacy description: GitHub Add Team Member (legacy) hints: readOnly: false destructive: false idempotent: true call: teams-teams.addteammemberlegacy outputParameters: - type: object mapping: $. - name: github-remove-team-member-legacy description: GitHub Remove Team Member (legacy) hints: readOnly: false destructive: true idempotent: true call: teams-teams.removeteammemberlegacy outputParameters: - type: object mapping: $. - name: github-get-team-membership-user-2 description: GitHub Get Team Membership for User (legacy) hints: readOnly: true destructive: false idempotent: true call: teams-teams.getteammembershipforuserlegacy outputParameters: - type: object mapping: $. - name: github-add-update-team-membership-2 description: GitHub Add or Update Team Membership for User (legacy) hints: readOnly: false destructive: false idempotent: true call: teams-teams.addorupdateteammembershipforuserlegacy with: body: tools.body outputParameters: - type: object mapping: $. - name: github-remove-team-membership-user-2 description: GitHub Remove Team Membership for User (legacy) hints: readOnly: false destructive: true idempotent: true call: teams-teams.removeteammembershipforuserlegacy outputParameters: - type: object mapping: $. - name: github-list-team-projects-legacy description: GitHub List Team Projects (legacy) hints: readOnly: true destructive: false idempotent: true call: teams-teams.listteamprojectslegacy outputParameters: - type: object mapping: $. - name: github-check-team-permissions-project-2 description: GitHub Check Team Permissions for Project (legacy) hints: readOnly: true destructive: false idempotent: true call: teams-teams.checkteampermissionsforprojectlegacy outputParameters: - type: object mapping: $. - name: github-add-update-team-project-2 description: GitHub Add or Update Team Project Permissions (legacy) hints: readOnly: false destructive: false idempotent: true call: teams-teams.addorupdateteamprojectpermissionslegacy with: body: tools.body outputParameters: - type: object mapping: $. - name: github-remove-project-team-legacy description: GitHub Remove Project from Team (legacy) hints: readOnly: false destructive: true idempotent: true call: teams-teams.removeprojectfromteamlegacy outputParameters: - type: object mapping: $. - name: github-list-team-repositories-legacy description: GitHub List Team Repositories (legacy) hints: readOnly: true destructive: false idempotent: true call: teams-teams.listteamrepositorieslegacy outputParameters: - type: object mapping: $. - name: github-check-team-permissions-repository-2 description: GitHub Check Team Permissions for Repository (legacy) hints: readOnly: true destructive: false idempotent: true call: teams-teams.checkteampermissionsforrepositorylegacy outputParameters: - type: object mapping: $. - name: github-add-update-team-repository-2 description: GitHub Add or Update Team Repository Permissions (legacy) hints: readOnly: false destructive: false idempotent: true call: teams-teams.addorupdateteamrepositorypermissionslegacy with: body: tools.body outputParameters: - type: object mapping: $. - name: github-remove-repository-team-legacy description: GitHub Remove Repository from Team (legacy) hints: readOnly: false destructive: true idempotent: true call: teams-teams.removerepositoryfromteamlegacy outputParameters: - type: object mapping: $. - name: github-list-child-teams-legacy description: GitHub List Child Teams (legacy) hints: readOnly: true destructive: false idempotent: true call: teams-teams.listchildteamslegacy outputParameters: - type: object mapping: $. - name: github-list-teams-authenticated-user description: GitHub List Teams for the Authenticated User hints: readOnly: true destructive: false idempotent: true call: teams-teams.listteamsfortheauthenticateduser outputParameters: - type: object mapping: $.