naftiko: 1.0.0-alpha2 info: label: GitHub v3 REST API — Teams description: 'GitHub v3 REST API — Teams. 63 operations. Lead operation: GitHub Get an External Group. 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: github-teams baseUri: '' description: GitHub v3 REST API — Teams business capability. Self-contained, no shared references. resources: - name: orgs-org-external-group-group_id path: /orgs/{org}/external-group/{group_id} operations: - name: teamsexternalidpgroupinfofororg method: GET description: GitHub Get an External Group outputRawFormat: json outputParameters: - name: result type: object value: $. - name: orgs-org-external-groups path: /orgs/{org}/external-groups operations: - name: teamslistexternalidpgroupsfororg method: GET description: GitHub List External Groups in an Organization outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: page in: query type: integer description: Page token - name: display_name in: query type: string description: Limits the list to groups containing the text in the group name - name: orgs-org-teams path: /orgs/{org}/teams operations: - name: teamslist method: GET description: GitHub List Teams outputRawFormat: json outputParameters: - name: result type: object value: $. - name: teamscreate method: POST description: GitHub Create a 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: teamsgetbyname method: GET description: GitHub Get a Team by Name outputRawFormat: json outputParameters: - name: result type: object value: $. - name: teamsupdateinorg method: PATCH description: GitHub Update a Team outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: body in: body type: object description: Request body (JSON). required: false - name: teamsdeleteinorg method: DELETE description: GitHub Delete a Team outputRawFormat: json outputParameters: - name: result type: object value: $. - name: orgs-org-teams-team_slug-discussions path: /orgs/{org}/teams/{team_slug}/discussions operations: - name: teamslistdiscussionsinorg method: GET description: GitHub List Discussions outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: pinned in: query type: string description: Pinned discussions only filter - name: teamscreatediscussioninorg method: POST description: GitHub Create a 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 path: /orgs/{org}/teams/{team_slug}/discussions/{discussion_number} operations: - name: teamsgetdiscussioninorg method: GET description: GitHub Get a Discussion outputRawFormat: json outputParameters: - name: result type: object value: $. - name: teamsupdatediscussioninorg method: PATCH description: GitHub Update a Discussion outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: body in: body type: object description: Request body (JSON). required: false - name: teamsdeletediscussioninorg method: DELETE description: GitHub Delete a Discussion outputRawFormat: json outputParameters: - name: result type: object value: $. - name: orgs-org-teams-team_slug-discussions-discussion_number-comments path: /orgs/{org}/teams/{team_slug}/discussions/{discussion_number}/comments operations: - name: teamslistdiscussioncommentsinorg method: GET description: GitHub List Discussion Comments outputRawFormat: json outputParameters: - name: result type: object value: $. - name: teamscreatediscussioncommentinorg method: POST description: GitHub Create a 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 path: /orgs/{org}/teams/{team_slug}/discussions/{discussion_number}/comments/{comment_number} operations: - name: teamsgetdiscussioncommentinorg method: GET description: GitHub Get a Discussion Comment outputRawFormat: json outputParameters: - name: result type: object value: $. - name: teamsupdatediscussioncommentinorg method: PATCH description: GitHub Update a Discussion Comment outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: body in: body type: object description: Request body (JSON). required: true - name: teamsdeletediscussioncommentinorg method: DELETE description: GitHub Delete a Discussion Comment 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: teamslistlinkedexternalidpgroupstoteamfororg method: GET description: GitHub List a Connection Between an External Group and a Team outputRawFormat: json outputParameters: - name: result type: object value: $. - name: teamslinkexternalidpgrouptoteamfororg method: PATCH description: GitHub Update the Connection Between an External Group and a Team outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: body in: body type: object description: Request body (JSON). required: true - name: teamsunlinkexternalidpgroupfromteamfororg method: DELETE description: GitHub Remove the Connection Between an External Group and a 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: teamslistmembersinorg 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: teamsgetmembershipforuserinorg method: GET description: GitHub Get Team Membership for a User outputRawFormat: json outputParameters: - name: result type: object value: $. - name: teamsaddorupdatemembershipforuserinorg method: PUT description: GitHub Add or Update Team Membership for a User outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: body in: body type: object description: Request body (JSON). required: false - name: teamsremovemembershipforuserinorg method: DELETE description: GitHub Remove Team Membership for a 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: teamslistprojectsinorg 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: teamscheckpermissionsforprojectinorg method: GET description: GitHub Check Team Permissions for a Project outputRawFormat: json outputParameters: - name: result type: object value: $. - name: teamsaddorupdateprojectpermissionsinorg 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: teamsremoveprojectinorg method: DELETE description: GitHub Remove a Project from a 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: teamslistreposinorg 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: teamscheckpermissionsforrepoinorg method: GET description: GitHub Check Team Permissions for a Repository outputRawFormat: json outputParameters: - name: result type: object value: $. - name: teamsaddorupdaterepopermissionsinorg 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: teamsremoverepoinorg method: DELETE description: GitHub Remove a Repository from a 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: teamslistchildinorg method: GET description: GitHub List Child Teams outputRawFormat: json outputParameters: - name: result type: object value: $. - name: teams-team_id path: /teams/{team_id} operations: - name: teamsgetlegacy method: GET description: GitHub Get a Team (Legacy) outputRawFormat: json outputParameters: - name: result type: object value: $. - name: teamsupdatelegacy method: PATCH description: GitHub Update a Team (Legacy) outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: body in: body type: object description: Request body (JSON). required: true - name: teamsdeletelegacy method: DELETE description: GitHub Delete a Team (Legacy) outputRawFormat: json outputParameters: - name: result type: object value: $. - name: teams-team_id-discussions path: /teams/{team_id}/discussions operations: - name: teamslistdiscussionslegacy method: GET description: GitHub List Discussions (Legacy) outputRawFormat: json outputParameters: - name: result type: object value: $. - name: teamscreatediscussionlegacy method: POST description: GitHub Create a 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-discussions-discussion_number path: /teams/{team_id}/discussions/{discussion_number} operations: - name: teamsgetdiscussionlegacy method: GET description: GitHub Get a Discussion (Legacy) outputRawFormat: json outputParameters: - name: result type: object value: $. - name: teamsupdatediscussionlegacy method: PATCH description: GitHub Update a Discussion (Legacy) outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: body in: body type: object description: Request body (JSON). required: false - name: teamsdeletediscussionlegacy method: DELETE description: GitHub Delete a Discussion (Legacy) outputRawFormat: json outputParameters: - name: result type: object value: $. - name: teams-team_id-discussions-discussion_number-comments path: /teams/{team_id}/discussions/{discussion_number}/comments operations: - name: teamslistdiscussioncommentslegacy method: GET description: GitHub List Discussion Comments (Legacy) outputRawFormat: json outputParameters: - name: result type: object value: $. - name: teamscreatediscussioncommentlegacy method: POST description: GitHub Create a 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-comments-comment_number path: /teams/{team_id}/discussions/{discussion_number}/comments/{comment_number} operations: - name: teamsgetdiscussioncommentlegacy method: GET description: GitHub Get a Discussion Comment (Legacy) outputRawFormat: json outputParameters: - name: result type: object value: $. - name: teamsupdatediscussioncommentlegacy method: PATCH description: GitHub Update a 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: teamsdeletediscussioncommentlegacy method: DELETE description: GitHub Delete a Discussion Comment (Legacy) outputRawFormat: json outputParameters: - name: result type: object value: $. - name: teams-team_id-members path: /teams/{team_id}/members operations: - name: teamslistmemberslegacy 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: teamsgetmemberlegacy method: GET description: GitHub Get Team Member (Legacy) outputRawFormat: json outputParameters: - name: result type: object value: $. - name: teamsaddmemberlegacy method: PUT description: GitHub Add Team Member (Legacy) outputRawFormat: json outputParameters: - name: result type: object value: $. - name: teamsremovememberlegacy 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: teamsgetmembershipforuserlegacy method: GET description: GitHub Get Team Membership for a User (Legacy) outputRawFormat: json outputParameters: - name: result type: object value: $. - name: teamsaddorupdatemembershipforuserlegacy method: PUT description: GitHub Add or Update Team Membership for a User (Legacy) outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: body in: body type: object description: Request body (JSON). required: false - name: teamsremovemembershipforuserlegacy method: DELETE description: GitHub Remove Team Membership for a User (Legacy) outputRawFormat: json outputParameters: - name: result type: object value: $. - name: teams-team_id-projects path: /teams/{team_id}/projects operations: - name: teamslistprojectslegacy 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: teamscheckpermissionsforprojectlegacy method: GET description: GitHub Check Team Permissions for a Project (Legacy) outputRawFormat: json outputParameters: - name: result type: object value: $. - name: teamsaddorupdateprojectpermissionslegacy 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: teamsremoveprojectlegacy method: DELETE description: GitHub Remove a Project from a Team (Legacy) outputRawFormat: json outputParameters: - name: result type: object value: $. - name: teams-team_id-repos path: /teams/{team_id}/repos operations: - name: teamslistreposlegacy 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: teamscheckpermissionsforrepolegacy method: GET description: GitHub Check Team Permissions for a Repository (Legacy) outputRawFormat: json outputParameters: - name: result type: object value: $. - name: teamsaddorupdaterepopermissionslegacy 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: teamsremoverepolegacy method: DELETE description: GitHub Remove a Repository from a Team (Legacy) outputRawFormat: json outputParameters: - name: result type: object value: $. - name: teams-team_id-teams path: /teams/{team_id}/teams operations: - name: teamslistchildlegacy method: GET description: GitHub List Child Teams (Legacy) outputRawFormat: json outputParameters: - name: result type: object value: $. - name: user-teams path: /user/teams operations: - name: teamslistforauthenticateduser method: GET description: GitHub List Teams for the Authenticated User outputRawFormat: json outputParameters: - name: result type: object value: $. exposes: - type: rest namespace: github-teams-rest port: 8080 description: REST adapter for GitHub v3 REST API — Teams. One Spectral-compliant resource per consumed operation, prefixed with /v1. resources: - path: /v1/orgs/{org}/external-group/{group-id} name: orgs-org-external-group-group-id description: REST surface for orgs-org-external-group-group_id. operations: - method: GET name: teamsexternalidpgroupinfofororg description: GitHub Get an External Group call: github-teams.teamsexternalidpgroupinfofororg outputParameters: - type: object mapping: $. - path: /v1/orgs/{org}/external-groups name: orgs-org-external-groups description: REST surface for orgs-org-external-groups. operations: - method: GET name: teamslistexternalidpgroupsfororg description: GitHub List External Groups in an Organization call: github-teams.teamslistexternalidpgroupsfororg with: page: rest.page display_name: rest.display_name outputParameters: - type: object mapping: $. - path: /v1/orgs/{org}/teams name: orgs-org-teams description: REST surface for orgs-org-teams. operations: - method: GET name: teamslist description: GitHub List Teams call: github-teams.teamslist outputParameters: - type: object mapping: $. - method: POST name: teamscreate description: GitHub Create a Team call: github-teams.teamscreate 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: teamsgetbyname description: GitHub Get a Team by Name call: github-teams.teamsgetbyname outputParameters: - type: object mapping: $. - method: PATCH name: teamsupdateinorg description: GitHub Update a Team call: github-teams.teamsupdateinorg with: body: rest.body outputParameters: - type: object mapping: $. - method: DELETE name: teamsdeleteinorg description: GitHub Delete a Team call: github-teams.teamsdeleteinorg outputParameters: - type: object mapping: $. - path: /v1/orgs/{org}/teams/{team-slug}/discussions name: orgs-org-teams-team-slug-discussions description: REST surface for orgs-org-teams-team_slug-discussions. operations: - method: GET name: teamslistdiscussionsinorg description: GitHub List Discussions call: github-teams.teamslistdiscussionsinorg with: pinned: rest.pinned outputParameters: - type: object mapping: $. - method: POST name: teamscreatediscussioninorg description: GitHub Create a Discussion call: github-teams.teamscreatediscussioninorg with: body: rest.body outputParameters: - type: object mapping: $. - path: /v1/orgs/{org}/teams/{team-slug}/discussions/{discussion-number} name: orgs-org-teams-team-slug-discussions-discussion-number description: REST surface for orgs-org-teams-team_slug-discussions-discussion_number. operations: - method: GET name: teamsgetdiscussioninorg description: GitHub Get a Discussion call: github-teams.teamsgetdiscussioninorg outputParameters: - type: object mapping: $. - method: PATCH name: teamsupdatediscussioninorg description: GitHub Update a Discussion call: github-teams.teamsupdatediscussioninorg with: body: rest.body outputParameters: - type: object mapping: $. - method: DELETE name: teamsdeletediscussioninorg description: GitHub Delete a Discussion call: github-teams.teamsdeletediscussioninorg outputParameters: - type: object mapping: $. - path: /v1/orgs/{org}/teams/{team-slug}/discussions/{discussion-number}/comments name: orgs-org-teams-team-slug-discussions-discussion-number-comments description: REST surface for orgs-org-teams-team_slug-discussions-discussion_number-comments. operations: - method: GET name: teamslistdiscussioncommentsinorg description: GitHub List Discussion Comments call: github-teams.teamslistdiscussioncommentsinorg outputParameters: - type: object mapping: $. - method: POST name: teamscreatediscussioncommentinorg description: GitHub Create a Discussion Comment call: github-teams.teamscreatediscussioncommentinorg with: body: rest.body outputParameters: - type: object mapping: $. - path: /v1/orgs/{org}/teams/{team-slug}/discussions/{discussion-number}/comments/{comment-number} name: orgs-org-teams-team-slug-discussions-discussion-number-comments-comment-number description: REST surface for orgs-org-teams-team_slug-discussions-discussion_number-comments-comment_number. operations: - method: GET name: teamsgetdiscussioncommentinorg description: GitHub Get a Discussion Comment call: github-teams.teamsgetdiscussioncommentinorg outputParameters: - type: object mapping: $. - method: PATCH name: teamsupdatediscussioncommentinorg description: GitHub Update a Discussion Comment call: github-teams.teamsupdatediscussioncommentinorg with: body: rest.body outputParameters: - type: object mapping: $. - method: DELETE name: teamsdeletediscussioncommentinorg description: GitHub Delete a Discussion Comment call: github-teams.teamsdeletediscussioncommentinorg 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: teamslistlinkedexternalidpgroupstoteamfororg description: GitHub List a Connection Between an External Group and a Team call: github-teams.teamslistlinkedexternalidpgroupstoteamfororg outputParameters: - type: object mapping: $. - method: PATCH name: teamslinkexternalidpgrouptoteamfororg description: GitHub Update the Connection Between an External Group and a Team call: github-teams.teamslinkexternalidpgrouptoteamfororg with: body: rest.body outputParameters: - type: object mapping: $. - method: DELETE name: teamsunlinkexternalidpgroupfromteamfororg description: GitHub Remove the Connection Between an External Group and a Team call: github-teams.teamsunlinkexternalidpgroupfromteamfororg 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: teamslistmembersinorg description: GitHub List Team Members call: github-teams.teamslistmembersinorg 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: teamsgetmembershipforuserinorg description: GitHub Get Team Membership for a User call: github-teams.teamsgetmembershipforuserinorg outputParameters: - type: object mapping: $. - method: PUT name: teamsaddorupdatemembershipforuserinorg description: GitHub Add or Update Team Membership for a User call: github-teams.teamsaddorupdatemembershipforuserinorg with: body: rest.body outputParameters: - type: object mapping: $. - method: DELETE name: teamsremovemembershipforuserinorg description: GitHub Remove Team Membership for a User call: github-teams.teamsremovemembershipforuserinorg 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: teamslistprojectsinorg description: GitHub List Team Projects call: github-teams.teamslistprojectsinorg 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: teamscheckpermissionsforprojectinorg description: GitHub Check Team Permissions for a Project call: github-teams.teamscheckpermissionsforprojectinorg outputParameters: - type: object mapping: $. - method: PUT name: teamsaddorupdateprojectpermissionsinorg description: GitHub Add or Update Team Project Permissions call: github-teams.teamsaddorupdateprojectpermissionsinorg with: body: rest.body outputParameters: - type: object mapping: $. - method: DELETE name: teamsremoveprojectinorg description: GitHub Remove a Project from a Team call: github-teams.teamsremoveprojectinorg 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: teamslistreposinorg description: GitHub List Team Repositories call: github-teams.teamslistreposinorg 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: teamscheckpermissionsforrepoinorg description: GitHub Check Team Permissions for a Repository call: github-teams.teamscheckpermissionsforrepoinorg outputParameters: - type: object mapping: $. - method: PUT name: teamsaddorupdaterepopermissionsinorg description: GitHub Add or Update Team Repository Permissions call: github-teams.teamsaddorupdaterepopermissionsinorg with: body: rest.body outputParameters: - type: object mapping: $. - method: DELETE name: teamsremoverepoinorg description: GitHub Remove a Repository from a Team call: github-teams.teamsremoverepoinorg 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: teamslistchildinorg description: GitHub List Child Teams call: github-teams.teamslistchildinorg outputParameters: - type: object mapping: $. - path: /v1/teams/{team-id} name: teams-team-id description: REST surface for teams-team_id. operations: - method: GET name: teamsgetlegacy description: GitHub Get a Team (Legacy) call: github-teams.teamsgetlegacy outputParameters: - type: object mapping: $. - method: PATCH name: teamsupdatelegacy description: GitHub Update a Team (Legacy) call: github-teams.teamsupdatelegacy with: body: rest.body outputParameters: - type: object mapping: $. - method: DELETE name: teamsdeletelegacy description: GitHub Delete a Team (Legacy) call: github-teams.teamsdeletelegacy outputParameters: - type: object mapping: $. - path: /v1/teams/{team-id}/discussions name: teams-team-id-discussions description: REST surface for teams-team_id-discussions. operations: - method: GET name: teamslistdiscussionslegacy description: GitHub List Discussions (Legacy) call: github-teams.teamslistdiscussionslegacy outputParameters: - type: object mapping: $. - method: POST name: teamscreatediscussionlegacy description: GitHub Create a Discussion (Legacy) call: github-teams.teamscreatediscussionlegacy with: body: rest.body outputParameters: - type: object mapping: $. - path: /v1/teams/{team-id}/discussions/{discussion-number} name: teams-team-id-discussions-discussion-number description: REST surface for teams-team_id-discussions-discussion_number. operations: - method: GET name: teamsgetdiscussionlegacy description: GitHub Get a Discussion (Legacy) call: github-teams.teamsgetdiscussionlegacy outputParameters: - type: object mapping: $. - method: PATCH name: teamsupdatediscussionlegacy description: GitHub Update a Discussion (Legacy) call: github-teams.teamsupdatediscussionlegacy with: body: rest.body outputParameters: - type: object mapping: $. - method: DELETE name: teamsdeletediscussionlegacy description: GitHub Delete a Discussion (Legacy) call: github-teams.teamsdeletediscussionlegacy outputParameters: - type: object mapping: $. - path: /v1/teams/{team-id}/discussions/{discussion-number}/comments name: teams-team-id-discussions-discussion-number-comments description: REST surface for teams-team_id-discussions-discussion_number-comments. operations: - method: GET name: teamslistdiscussioncommentslegacy description: GitHub List Discussion Comments (Legacy) call: github-teams.teamslistdiscussioncommentslegacy outputParameters: - type: object mapping: $. - method: POST name: teamscreatediscussioncommentlegacy description: GitHub Create a Discussion Comment (Legacy) call: github-teams.teamscreatediscussioncommentlegacy with: body: rest.body outputParameters: - type: object mapping: $. - path: /v1/teams/{team-id}/discussions/{discussion-number}/comments/{comment-number} name: teams-team-id-discussions-discussion-number-comments-comment-number description: REST surface for teams-team_id-discussions-discussion_number-comments-comment_number. operations: - method: GET name: teamsgetdiscussioncommentlegacy description: GitHub Get a Discussion Comment (Legacy) call: github-teams.teamsgetdiscussioncommentlegacy outputParameters: - type: object mapping: $. - method: PATCH name: teamsupdatediscussioncommentlegacy description: GitHub Update a Discussion Comment (Legacy) call: github-teams.teamsupdatediscussioncommentlegacy with: body: rest.body outputParameters: - type: object mapping: $. - method: DELETE name: teamsdeletediscussioncommentlegacy description: GitHub Delete a Discussion Comment (Legacy) call: github-teams.teamsdeletediscussioncommentlegacy 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: teamslistmemberslegacy description: GitHub List Team Members (Legacy) call: github-teams.teamslistmemberslegacy 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: teamsgetmemberlegacy description: GitHub Get Team Member (Legacy) call: github-teams.teamsgetmemberlegacy outputParameters: - type: object mapping: $. - method: PUT name: teamsaddmemberlegacy description: GitHub Add Team Member (Legacy) call: github-teams.teamsaddmemberlegacy outputParameters: - type: object mapping: $. - method: DELETE name: teamsremovememberlegacy description: GitHub Remove Team Member (Legacy) call: github-teams.teamsremovememberlegacy 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: teamsgetmembershipforuserlegacy description: GitHub Get Team Membership for a User (Legacy) call: github-teams.teamsgetmembershipforuserlegacy outputParameters: - type: object mapping: $. - method: PUT name: teamsaddorupdatemembershipforuserlegacy description: GitHub Add or Update Team Membership for a User (Legacy) call: github-teams.teamsaddorupdatemembershipforuserlegacy with: body: rest.body outputParameters: - type: object mapping: $. - method: DELETE name: teamsremovemembershipforuserlegacy description: GitHub Remove Team Membership for a User (Legacy) call: github-teams.teamsremovemembershipforuserlegacy 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: teamslistprojectslegacy description: GitHub List Team Projects (Legacy) call: github-teams.teamslistprojectslegacy 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: teamscheckpermissionsforprojectlegacy description: GitHub Check Team Permissions for a Project (Legacy) call: github-teams.teamscheckpermissionsforprojectlegacy outputParameters: - type: object mapping: $. - method: PUT name: teamsaddorupdateprojectpermissionslegacy description: GitHub Add or Update Team Project Permissions (Legacy) call: github-teams.teamsaddorupdateprojectpermissionslegacy with: body: rest.body outputParameters: - type: object mapping: $. - method: DELETE name: teamsremoveprojectlegacy description: GitHub Remove a Project from a Team (Legacy) call: github-teams.teamsremoveprojectlegacy 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: teamslistreposlegacy description: GitHub List Team Repositories (Legacy) call: github-teams.teamslistreposlegacy 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: teamscheckpermissionsforrepolegacy description: GitHub Check Team Permissions for a Repository (Legacy) call: github-teams.teamscheckpermissionsforrepolegacy outputParameters: - type: object mapping: $. - method: PUT name: teamsaddorupdaterepopermissionslegacy description: GitHub Add or Update Team Repository Permissions (Legacy) call: github-teams.teamsaddorupdaterepopermissionslegacy with: body: rest.body outputParameters: - type: object mapping: $. - method: DELETE name: teamsremoverepolegacy description: GitHub Remove a Repository from a Team (Legacy) call: github-teams.teamsremoverepolegacy 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: teamslistchildlegacy description: GitHub List Child Teams (Legacy) call: github-teams.teamslistchildlegacy outputParameters: - type: object mapping: $. - path: /v1/user/teams name: user-teams description: REST surface for user-teams. operations: - method: GET name: teamslistforauthenticateduser description: GitHub List Teams for the Authenticated User call: github-teams.teamslistforauthenticateduser outputParameters: - type: object mapping: $. - type: mcp namespace: github-teams-mcp port: 9090 transport: http description: MCP adapter for GitHub v3 REST API — Teams. One tool per consumed operation, routed inline through this capability's consumes block. tools: - name: github-get-external-group description: GitHub Get an External Group hints: readOnly: true destructive: false idempotent: true call: github-teams.teamsexternalidpgroupinfofororg outputParameters: - type: object mapping: $. - name: github-list-external-groups-organization description: GitHub List External Groups in an Organization hints: readOnly: true destructive: false idempotent: true call: github-teams.teamslistexternalidpgroupsfororg with: page: tools.page display_name: tools.display_name outputParameters: - type: object mapping: $. - name: github-list-teams description: GitHub List Teams hints: readOnly: true destructive: false idempotent: true call: github-teams.teamslist outputParameters: - type: object mapping: $. - name: github-create-team description: GitHub Create a Team hints: readOnly: false destructive: false idempotent: false call: github-teams.teamscreate with: body: tools.body outputParameters: - type: object mapping: $. - name: github-get-team-name description: GitHub Get a Team by Name hints: readOnly: true destructive: false idempotent: true call: github-teams.teamsgetbyname outputParameters: - type: object mapping: $. - name: github-update-team description: GitHub Update a Team hints: readOnly: false destructive: false idempotent: true call: github-teams.teamsupdateinorg with: body: tools.body outputParameters: - type: object mapping: $. - name: github-delete-team description: GitHub Delete a Team hints: readOnly: false destructive: true idempotent: true call: github-teams.teamsdeleteinorg outputParameters: - type: object mapping: $. - name: github-list-discussions description: GitHub List Discussions hints: readOnly: true destructive: false idempotent: true call: github-teams.teamslistdiscussionsinorg with: pinned: tools.pinned outputParameters: - type: object mapping: $. - name: github-create-discussion description: GitHub Create a Discussion hints: readOnly: false destructive: false idempotent: false call: github-teams.teamscreatediscussioninorg with: body: tools.body outputParameters: - type: object mapping: $. - name: github-get-discussion description: GitHub Get a Discussion hints: readOnly: true destructive: false idempotent: true call: github-teams.teamsgetdiscussioninorg outputParameters: - type: object mapping: $. - name: github-update-discussion description: GitHub Update a Discussion hints: readOnly: false destructive: false idempotent: true call: github-teams.teamsupdatediscussioninorg with: body: tools.body outputParameters: - type: object mapping: $. - name: github-delete-discussion description: GitHub Delete a Discussion hints: readOnly: false destructive: true idempotent: true call: github-teams.teamsdeletediscussioninorg outputParameters: - type: object mapping: $. - name: github-list-discussion-comments description: GitHub List Discussion Comments hints: readOnly: true destructive: false idempotent: true call: github-teams.teamslistdiscussioncommentsinorg outputParameters: - type: object mapping: $. - name: github-create-discussion-comment description: GitHub Create a Discussion Comment hints: readOnly: false destructive: false idempotent: false call: github-teams.teamscreatediscussioncommentinorg with: body: tools.body outputParameters: - type: object mapping: $. - name: github-get-discussion-comment description: GitHub Get a Discussion Comment hints: readOnly: true destructive: false idempotent: true call: github-teams.teamsgetdiscussioncommentinorg outputParameters: - type: object mapping: $. - name: github-update-discussion-comment description: GitHub Update a Discussion Comment hints: readOnly: false destructive: false idempotent: true call: github-teams.teamsupdatediscussioncommentinorg with: body: tools.body outputParameters: - type: object mapping: $. - name: github-delete-discussion-comment description: GitHub Delete a Discussion Comment hints: readOnly: false destructive: true idempotent: true call: github-teams.teamsdeletediscussioncommentinorg outputParameters: - type: object mapping: $. - name: github-list-connection-between-external description: GitHub List a Connection Between an External Group and a Team hints: readOnly: true destructive: false idempotent: true call: github-teams.teamslistlinkedexternalidpgroupstoteamfororg outputParameters: - type: object mapping: $. - name: github-update-connection-between-external description: GitHub Update the Connection Between an External Group and a Team hints: readOnly: false destructive: false idempotent: true call: github-teams.teamslinkexternalidpgrouptoteamfororg with: body: tools.body outputParameters: - type: object mapping: $. - name: github-remove-connection-between-external description: GitHub Remove the Connection Between an External Group and a Team hints: readOnly: false destructive: true idempotent: true call: github-teams.teamsunlinkexternalidpgroupfromteamfororg outputParameters: - type: object mapping: $. - name: github-list-team-members description: GitHub List Team Members hints: readOnly: true destructive: false idempotent: true call: github-teams.teamslistmembersinorg with: role: tools.role outputParameters: - type: object mapping: $. - name: github-get-team-membership-user description: GitHub Get Team Membership for a User hints: readOnly: true destructive: false idempotent: true call: github-teams.teamsgetmembershipforuserinorg outputParameters: - type: object mapping: $. - name: github-add-update-team-membership description: GitHub Add or Update Team Membership for a User hints: readOnly: false destructive: false idempotent: true call: github-teams.teamsaddorupdatemembershipforuserinorg with: body: tools.body outputParameters: - type: object mapping: $. - name: github-remove-team-membership-user description: GitHub Remove Team Membership for a User hints: readOnly: false destructive: true idempotent: true call: github-teams.teamsremovemembershipforuserinorg outputParameters: - type: object mapping: $. - name: github-list-team-projects description: GitHub List Team Projects hints: readOnly: true destructive: false idempotent: true call: github-teams.teamslistprojectsinorg outputParameters: - type: object mapping: $. - name: github-check-team-permissions-project description: GitHub Check Team Permissions for a Project hints: readOnly: true destructive: false idempotent: true call: github-teams.teamscheckpermissionsforprojectinorg 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: github-teams.teamsaddorupdateprojectpermissionsinorg with: body: tools.body outputParameters: - type: object mapping: $. - name: github-remove-project-team description: GitHub Remove a Project from a Team hints: readOnly: false destructive: true idempotent: true call: github-teams.teamsremoveprojectinorg outputParameters: - type: object mapping: $. - name: github-list-team-repositories description: GitHub List Team Repositories hints: readOnly: true destructive: false idempotent: true call: github-teams.teamslistreposinorg outputParameters: - type: object mapping: $. - name: github-check-team-permissions-repository description: GitHub Check Team Permissions for a Repository hints: readOnly: true destructive: false idempotent: true call: github-teams.teamscheckpermissionsforrepoinorg 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: github-teams.teamsaddorupdaterepopermissionsinorg with: body: tools.body outputParameters: - type: object mapping: $. - name: github-remove-repository-team description: GitHub Remove a Repository from a Team hints: readOnly: false destructive: true idempotent: true call: github-teams.teamsremoverepoinorg outputParameters: - type: object mapping: $. - name: github-list-child-teams description: GitHub List Child Teams hints: readOnly: true destructive: false idempotent: true call: github-teams.teamslistchildinorg outputParameters: - type: object mapping: $. - name: github-get-team-legacy description: GitHub Get a Team (Legacy) hints: readOnly: true destructive: false idempotent: true call: github-teams.teamsgetlegacy outputParameters: - type: object mapping: $. - name: github-update-team-legacy description: GitHub Update a Team (Legacy) hints: readOnly: false destructive: false idempotent: true call: github-teams.teamsupdatelegacy with: body: tools.body outputParameters: - type: object mapping: $. - name: github-delete-team-legacy description: GitHub Delete a Team (Legacy) hints: readOnly: false destructive: true idempotent: true call: github-teams.teamsdeletelegacy outputParameters: - type: object mapping: $. - name: github-list-discussions-legacy description: GitHub List Discussions (Legacy) hints: readOnly: true destructive: false idempotent: true call: github-teams.teamslistdiscussionslegacy outputParameters: - type: object mapping: $. - name: github-create-discussion-legacy description: GitHub Create a Discussion (Legacy) hints: readOnly: false destructive: false idempotent: false call: github-teams.teamscreatediscussionlegacy with: body: tools.body outputParameters: - type: object mapping: $. - name: github-get-discussion-legacy description: GitHub Get a Discussion (Legacy) hints: readOnly: true destructive: false idempotent: true call: github-teams.teamsgetdiscussionlegacy outputParameters: - type: object mapping: $. - name: github-update-discussion-legacy description: GitHub Update a Discussion (Legacy) hints: readOnly: false destructive: false idempotent: true call: github-teams.teamsupdatediscussionlegacy with: body: tools.body outputParameters: - type: object mapping: $. - name: github-delete-discussion-legacy description: GitHub Delete a Discussion (Legacy) hints: readOnly: false destructive: true idempotent: true call: github-teams.teamsdeletediscussionlegacy outputParameters: - type: object mapping: $. - name: github-list-discussion-comments-legacy description: GitHub List Discussion Comments (Legacy) hints: readOnly: true destructive: false idempotent: true call: github-teams.teamslistdiscussioncommentslegacy outputParameters: - type: object mapping: $. - name: github-create-discussion-comment-legacy description: GitHub Create a Discussion Comment (Legacy) hints: readOnly: false destructive: false idempotent: false call: github-teams.teamscreatediscussioncommentlegacy with: body: tools.body outputParameters: - type: object mapping: $. - name: github-get-discussion-comment-legacy description: GitHub Get a Discussion Comment (Legacy) hints: readOnly: true destructive: false idempotent: true call: github-teams.teamsgetdiscussioncommentlegacy outputParameters: - type: object mapping: $. - name: github-update-discussion-comment-legacy description: GitHub Update a Discussion Comment (Legacy) hints: readOnly: false destructive: false idempotent: true call: github-teams.teamsupdatediscussioncommentlegacy with: body: tools.body outputParameters: - type: object mapping: $. - name: github-delete-discussion-comment-legacy description: GitHub Delete a Discussion Comment (Legacy) hints: readOnly: false destructive: true idempotent: true call: github-teams.teamsdeletediscussioncommentlegacy outputParameters: - type: object mapping: $. - name: github-list-team-members-legacy description: GitHub List Team Members (Legacy) hints: readOnly: true destructive: false idempotent: true call: github-teams.teamslistmemberslegacy 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: github-teams.teamsgetmemberlegacy outputParameters: - type: object mapping: $. - name: github-add-team-member-legacy description: GitHub Add Team Member (Legacy) hints: readOnly: false destructive: false idempotent: true call: github-teams.teamsaddmemberlegacy outputParameters: - type: object mapping: $. - name: github-remove-team-member-legacy description: GitHub Remove Team Member (Legacy) hints: readOnly: false destructive: true idempotent: true call: github-teams.teamsremovememberlegacy outputParameters: - type: object mapping: $. - name: github-get-team-membership-user-2 description: GitHub Get Team Membership for a User (Legacy) hints: readOnly: true destructive: false idempotent: true call: github-teams.teamsgetmembershipforuserlegacy outputParameters: - type: object mapping: $. - name: github-add-update-team-membership-2 description: GitHub Add or Update Team Membership for a User (Legacy) hints: readOnly: false destructive: false idempotent: true call: github-teams.teamsaddorupdatemembershipforuserlegacy with: body: tools.body outputParameters: - type: object mapping: $. - name: github-remove-team-membership-user-2 description: GitHub Remove Team Membership for a User (Legacy) hints: readOnly: false destructive: true idempotent: true call: github-teams.teamsremovemembershipforuserlegacy outputParameters: - type: object mapping: $. - name: github-list-team-projects-legacy description: GitHub List Team Projects (Legacy) hints: readOnly: true destructive: false idempotent: true call: github-teams.teamslistprojectslegacy outputParameters: - type: object mapping: $. - name: github-check-team-permissions-project-2 description: GitHub Check Team Permissions for a Project (Legacy) hints: readOnly: true destructive: false idempotent: true call: github-teams.teamscheckpermissionsforprojectlegacy 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: github-teams.teamsaddorupdateprojectpermissionslegacy with: body: tools.body outputParameters: - type: object mapping: $. - name: github-remove-project-team-legacy description: GitHub Remove a Project from a Team (Legacy) hints: readOnly: false destructive: true idempotent: true call: github-teams.teamsremoveprojectlegacy outputParameters: - type: object mapping: $. - name: github-list-team-repositories-legacy description: GitHub List Team Repositories (Legacy) hints: readOnly: true destructive: false idempotent: true call: github-teams.teamslistreposlegacy outputParameters: - type: object mapping: $. - name: github-check-team-permissions-repository-2 description: GitHub Check Team Permissions for a Repository (Legacy) hints: readOnly: true destructive: false idempotent: true call: github-teams.teamscheckpermissionsforrepolegacy 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: github-teams.teamsaddorupdaterepopermissionslegacy with: body: tools.body outputParameters: - type: object mapping: $. - name: github-remove-repository-team-legacy description: GitHub Remove a Repository from a Team (Legacy) hints: readOnly: false destructive: true idempotent: true call: github-teams.teamsremoverepolegacy outputParameters: - type: object mapping: $. - name: github-list-child-teams-legacy description: GitHub List Child Teams (Legacy) hints: readOnly: true destructive: false idempotent: true call: github-teams.teamslistchildlegacy 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: github-teams.teamslistforauthenticateduser outputParameters: - type: object mapping: $.