GitHub

GitHub Teams API

Interact with GitHub Teams.

GitHub OpenAPI

Operations 63

Each operation below carries the questions people ask an LLM about it and the instructions they give an agent to run it. Generated by API Evangelist overlay

GET /orgs/{org}/external-group/{group_id} Look up an external identity provider group · GitHub Get an External Group #
Ask an LLM
“Which members and teams are tied to one of our external IdP groups?”
“Can I see how a single identity provider group is being used in my GitHub org?”
Tell an agent
Show external group {group_id} in the {org} organization.
List the external members and connected teams for IdP group {group_id} in {org}.
GET /orgs/{org}/external-groups List external IdP groups in an organization · GitHub List External Groups in an Organization #
Ask an LLM
“What external identity provider groups are available to my organization?”
“Can I search our IdP groups by part of the group name?”
Tell an agent
List all external IdP groups available in {org}.
Find external groups in {org} whose name contains {display_name}.
GET /orgs/{org}/teams List the teams in an organization · GitHub List Teams #
Ask an LLM
“What teams exist in my organization?”
“Which teams in the org can I actually see with my account?”
Tell an agent
List every team in the {org} organization.
Show the teams visible to me in {org}, {per_page} per page.
POST /orgs/{org}/teams Create a team in an organization · GitHub Create a Team #
Ask an LLM
“How do I create a new team in my GitHub organization?”
“Can I make a secret team that only its members and org owners can see?”
Tell an agent
Create a team called {name} in {org}.
Create team {name} in {org} with privacy {privacy} and description {description}.
GET /orgs/{org}/teams/{team_slug} Get a team by its slug · GitHub Get a Team by Name #
Ask an LLM
“How can I look up a team's details from its slug?”
“What privacy setting and parent does a particular team have?”
Tell an agent
Get the team {team_slug} in {org}.
Show me the details of the {team_slug} team in the {org} organization.
PATCH /orgs/{org}/teams/{team_slug} Update a team's settings · GitHub Update a Team #
Ask an LLM
“Can I rename an existing team or change its description?”
“How would I move an existing team under a different parent team?”
Tell an agent
Rename team {team_slug} in {org} to {name}.
Change the privacy of team {team_slug} in {org} to {privacy}.
DELETE /orgs/{org}/teams/{team_slug} Delete a team from an organization · GitHub Delete a Team #
Ask an LLM
“What happens to child teams when I delete a parent team in my org?”
“Who is allowed to delete a team in an organization?”
Tell an agent destructive · confirm first
Delete the team {team_slug} from {org}.
Remove team {team_slug} entirely from the {org} organization.
GET /orgs/{org}/teams/{team_slug}/discussions List discussions on a team's page · GitHub List Discussions #
Ask an LLM
“What discussions have been posted on my team's page?”
“Can I see only the pinned discussions for a team?”
Tell an agent
List discussions on the {team_slug} team page in {org}.
Show pinned discussions for team {team_slug} in {org}, sorted {direction}.
POST /orgs/{org}/teams/{team_slug}/discussions Post a new team discussion · GitHub Create a Discussion #
Ask an LLM
“How can I start a discussion on my team's page?”
“Can I post a team discussion that only team members can see?”
Tell an agent
Post a discussion titled {title} saying {body} on the {team_slug} team in {org}.
Start a private discussion {title} for team {team_slug} in {org} with text {body}.
GET /orgs/{org}/teams/{team_slug}/discussions/{discussion_number} Get one team discussion · GitHub Get a Discussion #
Ask an LLM
“Can I pull up a single discussion post from a team page by its number?”
“What did a specific team discussion say?”
Tell an agent
Get discussion {discussion_number} on team {team_slug} in {org}.
Open team discussion number {discussion_number} for {team_slug} in the {org} org.
PATCH /orgs/{org}/teams/{team_slug}/discussions/{discussion_number} Edit a team discussion's title or body · GitHub Update a Discussion #
Ask an LLM
“Can I fix a typo in the title of a team discussion I already posted?”
“Is it possible to edit the body text of an existing team discussion?”
Tell an agent
Change the title of discussion {discussion_number} on team {team_slug} in {org} to {title}.
Edit the body of team discussion {discussion_number} for {team_slug} in {org} to read {body}.
DELETE /orgs/{org}/teams/{team_slug}/discussions/{discussion_number} Delete a team discussion · GitHub Delete a Discussion #
Ask an LLM
“How do I remove a discussion post from my team's page?”
“Can a team discussion be deleted once it has been posted?”
Tell an agent destructive · confirm first
Delete discussion {discussion_number} from the {team_slug} team in {org}.
Remove team discussion post {discussion_number} for {team_slug} in the {org} organization.
GET /orgs/{org}/teams/{team_slug}/discussions/{discussion_number}/comments List comments on a team discussion · GitHub List Discussion Comments #
Ask an LLM
“What replies have people left on a team discussion?”
“Can I read the comments on a team discussion oldest first?”
Tell an agent
List comments on discussion {discussion_number} for team {team_slug} in {org}.
Show replies to team discussion {discussion_number} on {team_slug} in {org}, sorted {direction}.
POST /orgs/{org}/teams/{team_slug}/discussions/{discussion_number}/comments Comment on a team discussion · GitHub Create a Discussion Comment #
Ask an LLM
“How do I reply to a discussion on my team's page?”
“Does adding a comment to a team discussion notify people?”
Tell an agent
Comment {body} on discussion {discussion_number} for team {team_slug} in {org}.
Reply to team discussion {discussion_number} on {team_slug} in {org} with {body}.
GET /orgs/{org}/teams/{team_slug}/discussions/{discussion_number}/comments/{comment_number} Get one comment on a team discussion · GitHub Get a Discussion Comment #
Ask an LLM
“Can I fetch a single reply on a team discussion by its comment number?”
“What exactly did one specific comment on our team discussion say?”
Tell an agent
Fetch the single reply {comment_number} on discussion {discussion_number} for team {team_slug} in {org}.
Show reply {comment_number} in team discussion {discussion_number} of {team_slug}, {org}.
PATCH /orgs/{org}/teams/{team_slug}/discussions/{discussion_number}/comments/{comment_number} Edit a comment on a team discussion · GitHub Update a Discussion Comment #
Ask an LLM
“Can I edit a reply I already left on a team discussion?”
“Is there a way to correct the text of an existing team discussion comment?”
Tell an agent
Change comment {comment_number} on discussion {discussion_number} for team {team_slug} in {org} to {body}.
Rewrite my reply {comment_number} in {team_slug}'s discussion {discussion_number} ({org}) as {body}.
DELETE /orgs/{org}/teams/{team_slug}/discussions/{discussion_number}/comments/{comment_number} Delete a comment on a team discussion · GitHub Delete a Discussion Comment #
Ask an LLM
“How can I remove a reply someone posted on a team discussion?”
“Is deleting a team discussion comment permanent?”
Tell an agent destructive · confirm first
Delete comment {comment_number} from discussion {discussion_number} on team {team_slug} in {org}.
Remove reply {comment_number} under team discussion {discussion_number} for {team_slug} in the {org} org.
GET /orgs/{org}/teams/{team_slug}/external-groups See which external group is linked to a team · GitHub List a Connection Between an External Group and a Team #
Ask an LLM
“Which identity provider group is connected to this team?”
“Is my team's membership being managed by an external IdP group?”
Tell an agent
Show the external group linked to team {team_slug} in {org}.
Check whether team {team_slug} in {org} is connected to an IdP group.
GET /orgs/{org}/teams/{team_slug}/members List the members of a team · GitHub List Team Members #
Ask an LLM
“Who is on a particular team in my org?”
“Can I list only the maintainers of a team?”
Tell an agent
List the members of team {team_slug} in {org}.
Show members of {team_slug} in {org} who have the {role} role.
GET /orgs/{org}/teams/{team_slug}/memberships/{username} Check a user's membership in a team · GitHub Get Team Membership for a User #
Ask an LLM
“Is a specific person a member or maintainer of my team?”
“Can I tell whether someone's team membership is still pending?”
Tell an agent
Check {username}'s membership in team {team_slug} in {org}.
Get the team role and membership state of {username} on {team_slug} in the {org} org.
PUT /orgs/{org}/teams/{team_slug}/memberships/{username} Add a user to a team or change their role · GitHub Add or Update Team Membership for a User #
Ask an LLM
“How do I add someone in my org to a team?”
“Can I promote a team member to maintainer?”
Tell an agent
Add {username} to team {team_slug} in {org}.
Set {username}'s role on team {team_slug} in {org} to {role}.
DELETE /orgs/{org}/teams/{team_slug}/memberships/{username} Remove a user from a team · GitHub Remove Team Membership for a User #
Ask an LLM
“How can I take someone off a team without removing them from the org?”
“What permission do I need to remove a person from a team?”
Tell an agent destructive · confirm first
Remove {username} from team {team_slug} in {org}.
Take user {username} off the {team_slug} team in the {org} organization.
GET /orgs/{org}/teams/{team_slug}/projects List a team's projects · GitHub List Team Projects #
Ask an LLM
“Which organization projects does a team have access to?”
“What projects are assigned to my team?”
Tell an agent
List the projects for team {team_slug} in {org}.
Show every org project the {team_slug} team in {org} can reach.
GET /orgs/{org}/teams/{team_slug}/projects/{project_id} Check a team's permission on a project · GitHub Check Team Permissions for a Project #
Ask an LLM
“Does my team have read, write or admin access to a given project?”
“Are project permissions inherited from a parent team counted?”
Tell an agent
Check team {team_slug}'s permission on project {project_id} in {org}.
Tell me what access {team_slug} in {org} has to project {project_id}.
PUT /orgs/{org}/teams/{team_slug}/projects/{project_id} Grant a team access to a project · GitHub Add or Update Team Project Permissions #
Ask an LLM
“How do I give a team access to an organization project?”
“Can I change a team's permission on a project from read to admin?”
Tell an agent
Add project {project_id} to team {team_slug} in {org}.
Grant team {team_slug} in {org} {permission} permission on project {project_id}.
DELETE /orgs/{org}/teams/{team_slug}/projects/{project_id} Remove a project from a team · GitHub Remove a Project from a Team #
Ask an LLM
“How can I take a project away from a team?”
“Does removing a project from a team delete the project?”
Tell an agent destructive · confirm first
Remove project {project_id} from team {team_slug} in {org}.
Revoke the {team_slug} team's access to project {project_id} in the {org} org.
GET /orgs/{org}/teams/{team_slug}/repos List a team's repositories · GitHub List Team Repositories #
Ask an LLM
“Which repositories does my team have access to?”
“What repos are assigned to a team in the org?”
Tell an agent
List the repositories for team {team_slug} in {org}.
Show every repo the {team_slug} team in {org} can access.
GET /orgs/{org}/teams/{team_slug}/repos/{owner}/{repo} Check a team's permission on a repository · GitHub Check Team Permissions for a Repository #
Ask an LLM
“Does a team have push or admin rights on a specific repo?”
“What level of access does my team have to a repository, counting parent teams?”
Tell an agent
Check what repository role team {team_slug} holds on the {owner}/{repo} repo in {org}.
Tell me whether {team_slug} in {org} can push to repository {owner}/{repo}.
PUT /orgs/{org}/teams/{team_slug}/repos/{owner}/{repo} Grant a team access to a repository · GitHub Add or Update Team Repository Permissions #
Ask an LLM
“How do I give a team access to a repository?”
“Can I set a team to triage or maintain on a repo instead of full admin?”
Tell an agent
Add repository {owner}/{repo} to team {team_slug} in {org}.
Give team {team_slug} in {org} {permission} access to {owner}/{repo}.
DELETE /orgs/{org}/teams/{team_slug}/repos/{owner}/{repo} Remove a repository from a team · GitHub Remove a Repository from a Team #
Ask an LLM
“How can I stop a team from accessing a repository?”
“Does taking a repo away from a team delete the repo itself?”
Tell an agent destructive · confirm first
Detach the {owner}/{repo} repository from team {team_slug} in {org}.
Revoke the {team_slug} team's access to repository {owner}/{repo} in the {org} org.
GET /orgs/{org}/teams/{team_slug}/teams List a team's child teams · GitHub List Child Teams #
Ask an LLM
“Which teams are nested under a given parent team?”
“What sub-teams does my team have?”
Tell an agent
List the child teams of {team_slug} in {org}.
Show the nested sub-teams beneath team {team_slug} in the {org} org.
GET /teams/{team_id} Get a team by numeric ID (legacy) · GitHub Get a Team (Legacy) #
Ask an LLM
“Can I still fetch a team using only its numeric team ID?”
“Is the old get-team-by-ID route deprecated?”
Tell an agent
Using the legacy team ID route, get team {team_id}.
Fetch team details for numeric ID {team_id} via the deprecated endpoint.
PATCH /teams/{team_id} Update a team by numeric ID (legacy) · GitHub Update a Team (Legacy) #
Ask an LLM
“Can I rename a team through the old team ID endpoint?”
“Does the deprecated team update route require the name every time?”
Tell an agent
Using the legacy team ID route, rename team {team_id} to {name}.
Via the deprecated endpoint, set numeric team {team_id} name {name} and privacy {privacy}.
DELETE /teams/{team_id} Delete a team by numeric ID (legacy) · GitHub Delete a Team (Legacy) #
Ask an LLM
“Can I delete a team when all I have is its numeric ID?”
“Is deleting a team through the old ID-based route still supported?”
Tell an agent destructive · confirm first
Using the legacy team ID route, delete team {team_id}.
Delete numeric team ID {team_id} via the deprecated endpoint.
GET /teams/{team_id}/discussions List team discussions by team ID (legacy) · GitHub List Discussions (Legacy) #
Ask an LLM
“Can I list a team's discussions using its numeric ID instead of the slug?”
“Is the ID-based team discussion list going away?”
Tell an agent
Using the legacy team ID route, list discussions for team {team_id}.
Via the deprecated endpoint, show numeric team {team_id} discussions sorted {direction}.
POST /teams/{team_id}/discussions Post a team discussion by team ID (legacy) · GitHub Create a Discussion (Legacy) #
Ask an LLM
“Can I start a team discussion when I only know the numeric team ID?”
“Does the old ID-based discussion post route still trigger notifications?”
Tell an agent
Using the legacy team ID route, post discussion {title} with body {body} to team {team_id}.
Via the deprecated endpoint, open a new thread {title} on numeric team {team_id}: {body}.
GET /teams/{team_id}/discussions/{discussion_number} Get a team discussion by team ID (legacy) · GitHub Get a Discussion (Legacy) #
Ask an LLM
“Can I read one team discussion using the numeric team ID route?”
“Is fetching a single discussion by team ID deprecated?”
Tell an agent
Using the legacy team ID route, get discussion {discussion_number} of team {team_id}.
Via the deprecated endpoint, open thread {discussion_number} on numeric team {team_id}.
PATCH /teams/{team_id}/discussions/{discussion_number} Edit a team discussion by team ID (legacy) · GitHub Update a Discussion (Legacy) #
Ask an LLM
“Can I edit a team discussion's title using the numeric team ID?”
“Is the ID-based route for editing team discussions deprecated?”
Tell an agent
Using the legacy team ID route, retitle discussion {discussion_number} of team {team_id} to {title}.
Via the deprecated endpoint, change thread {discussion_number} body on numeric team {team_id} to {body}.
DELETE /teams/{team_id}/discussions/{discussion_number} Delete a team discussion by team ID (legacy) · GitHub Delete a Discussion (Legacy) #
Ask an LLM
“Can I remove a team discussion through the old numeric ID route?”
“Will deleting a discussion by team ID stop working in future?”
Tell an agent destructive · confirm first
Using the legacy team ID route, delete discussion {discussion_number} from team {team_id}.
Via the deprecated endpoint, erase thread {discussion_number} on numeric team {team_id}.
GET /teams/{team_id}/discussions/{discussion_number}/comments List discussion comments by team ID (legacy) · GitHub List Discussion Comments (Legacy) #
Ask an LLM
“Can I read a team discussion's replies through the numeric team ID route?”
“Is listing discussion comments by team ID being retired?”
Tell an agent
Using the legacy team ID route, list comments on discussion {discussion_number} of team {team_id}.
Via the deprecated endpoint, show replies to thread {discussion_number} on numeric team {team_id}.
POST /teams/{team_id}/discussions/{discussion_number}/comments Comment on a team discussion by team ID (legacy) · GitHub Create a Discussion Comment (Legacy) #
Ask an LLM
“Can I reply to a team discussion using the old numeric team ID route?”
“Is posting discussion comments by team ID deprecated?”
Tell an agent
Using the legacy team ID route, comment {body} on discussion {discussion_number} of team {team_id}.
Via the deprecated endpoint, add reply {body} to thread {discussion_number} on numeric team {team_id}.
GET /teams/{team_id}/discussions/{discussion_number}/comments/{comment_number} Get a discussion comment by team ID (legacy) · GitHub Get a Discussion Comment (Legacy) #
Ask an LLM
“Can I fetch one team discussion reply via the numeric team ID route?”
“Is the ID-based endpoint for a single discussion comment still around?”
Tell an agent
Using the legacy team ID route, fetch the single reply {comment_number} under discussion {discussion_number} of team {team_id}.
Via the deprecated endpoint, open reply {comment_number} in thread {discussion_number}, numeric team {team_id}.
PATCH /teams/{team_id}/discussions/{discussion_number}/comments/{comment_number} Edit a discussion comment by team ID (legacy) · GitHub Update a Discussion Comment (Legacy) #
Ask an LLM
“Can I edit a team discussion reply through the numeric team ID route?”
“Is changing a discussion comment by team ID still supported?”
Tell an agent
Using the legacy team ID route, change comment {comment_number} on discussion {discussion_number} of team {team_id} to {body}.
Via the deprecated endpoint, rewrite reply {comment_number} in thread {discussion_number}, numeric team {team_id}, as {body}.
DELETE /teams/{team_id}/discussions/{discussion_number}/comments/{comment_number} Delete a discussion comment by team ID (legacy) · GitHub Delete a Discussion Comment (Legacy) #
Ask an LLM
“Can I delete a team discussion reply through the numeric team ID route?”
“Is removing discussion comments by team ID deprecated?”
Tell an agent destructive · confirm first
Using the legacy team ID route, permanently delete reply {comment_number} under discussion {discussion_number} of team {team_id}.
Via the deprecated endpoint, erase reply {comment_number} in thread {discussion_number}, numeric team {team_id}.
GET /teams/{team_id}/members List team members by team ID (legacy) · GitHub List Team Members (Legacy) #
Ask an LLM
“Can I list a team's members using its numeric ID instead of its slug?”
“Is the ID-based team member list deprecated?”
Tell an agent
Using the legacy team ID route, list members of team {team_id}.
Via the deprecated endpoint, show numeric team {team_id} people with the {role} role.
GET /teams/{team_id}/members/{username} Check if a user is a team member (legacy) · GitHub Get Team Member (Legacy) #
Ask an LLM
“Is there an older endpoint that just tells me whether someone is on a team?”
“Does the deprecated get-team-member check include pending memberships?”
Tell an agent
Using the old get-team-member endpoint, check if {username} is on team {team_id}.
Confirm via the deprecated team member check that {username} belongs to numeric team {team_id}.
PUT /teams/{team_id}/members/{username} Add a user to a team (legacy add-member) · GitHub Add Team Member (Legacy) #
Ask an LLM
“Is there an older add-team-member endpoint that takes a numeric team ID?”
“Why is the old add team member call deprecated in favor of memberships?”
Tell an agent
Using the old add-team-member endpoint, add {username} to team {team_id}.
Put {username} on numeric team {team_id} with the deprecated add member call.
DELETE /teams/{team_id}/members/{username} Remove a user from a team (legacy remove-member) · GitHub Remove Team Member (Legacy) #
Ask an LLM
“Is there an old remove-team-member endpoint that works by team ID?”
“What replaced the deprecated remove team member call?”
Tell an agent destructive · confirm first
Using the old remove-team-member endpoint, remove {username} from team {team_id}.
Take {username} off numeric team {team_id} with the deprecated remove member call.
GET /teams/{team_id}/memberships/{username} Get a user's team membership by team ID (legacy) · GitHub Get Team Membership for a User (Legacy) #
Ask an LLM
“Can I check someone's team role and membership state by numeric team ID?”
“Is the ID-based team membership lookup being retired?”
Tell an agent
Using the legacy team ID route, get {username}'s membership in team {team_id}.
Via the deprecated memberships endpoint, show the role and state of {username} on numeric team {team_id}.
PUT /teams/{team_id}/memberships/{username} Add or change a team membership by team ID (legacy) · GitHub Add or Update Team Membership for a User (Legacy) #
Ask an LLM
“Can I set someone's team role using the numeric team ID memberships route?”
“Is adding memberships by team ID deprecated?”
Tell an agent
Using the legacy team ID route, add membership for {username} on team {team_id}.
Via the deprecated memberships endpoint, make {username} a {role} of numeric team {team_id}.
DELETE /teams/{team_id}/memberships/{username} Remove a team membership by team ID (legacy) · GitHub Remove Team Membership for a User (Legacy) #
Ask an LLM
“Can I remove someone's team membership using the numeric team ID route?”
“Is the ID-based memberships removal endpoint deprecated?”
Tell an agent destructive · confirm first
Using the legacy team ID route, delete {username}'s membership on team {team_id}.
Via the deprecated memberships endpoint, end membership of {username} in numeric team {team_id}.
GET /teams/{team_id}/projects List team projects by team ID (legacy) · GitHub List Team Projects (Legacy) #
Ask an LLM
“Can I list a team's projects with only its numeric team ID?”
“Is the ID-based team projects list deprecated?”
Tell an agent
Using the legacy team ID route, list projects for team {team_id}.
Via the deprecated endpoint, show org projects assigned to numeric team {team_id}.
GET /teams/{team_id}/projects/{project_id} Check team project access by team ID (legacy) · GitHub Check Team Permissions for a Project (Legacy) #
Ask an LLM
“Can I check a team's project permission via the numeric team ID route?”
“Is the ID-based project permission check going away?”
Tell an agent
Using the legacy team ID route, check team {team_id}'s permission on project {project_id}.
Via the deprecated endpoint, tell me numeric team {team_id} access level for project {project_id}.
PUT /teams/{team_id}/projects/{project_id} Grant a team project access by team ID (legacy) · GitHub Add or Update Team Project Permissions (Legacy) #
Ask an LLM
“Can I add a project to a team through the numeric team ID route?”
“Is granting project permissions by team ID deprecated?”
Tell an agent
Using the legacy team ID route, add project {project_id} to team {team_id}.
Via the deprecated endpoint, give numeric team {team_id} {permission} on project {project_id}.
DELETE /teams/{team_id}/projects/{project_id} Remove a project from a team by ID (legacy) · GitHub Remove a Project from a Team (Legacy) #
Ask an LLM
“Can I remove a project from a team via the numeric team ID route?”
“Is the ID-based remove-project endpoint deprecated?”
Tell an agent destructive · confirm first
Using the legacy team ID route, remove project {project_id} from team {team_id}.
Via the deprecated endpoint, revoke numeric team {team_id} access to project {project_id}.
GET /teams/{team_id}/repos List team repositories by team ID (legacy) · GitHub List Team Repositories (Legacy) #
Ask an LLM
“Can I list a team's repos using the numeric team ID?”
“Is the ID-based team repository list deprecated?”
Tell an agent
Using the legacy team ID route, list repositories for team {team_id}.
Via the deprecated endpoint, show repos accessible to numeric team {team_id}.
GET /teams/{team_id}/repos/{owner}/{repo} Check team repository access by team ID (legacy) · GitHub Check Team Permissions for a Repository (Legacy) #
Ask an LLM
“Can I see whether a numeric team ID has push, triage or admin on a repo?”
“Is the ID-based repository permission check being removed?”
Tell an agent
Using the legacy team ID route, check whether team {team_id} can pull, push or administer repository {owner}/{repo}.
Via the deprecated endpoint, tell me numeric team {team_id} access level for repository {owner}/{repo}.
PUT /teams/{team_id}/repos/{owner}/{repo} Grant a team repo access by team ID (legacy) · GitHub Add or Update Team Repository Permissions (Legacy) #
Ask an LLM
“Can I add a repository to a team using the numeric team ID route?”
“Is setting team repository permissions by team ID deprecated?”
Tell an agent
Using the legacy team ID route, attach the {owner}/{repo} repository to team {team_id}.
Via the deprecated endpoint, give numeric team {team_id} {permission} on repository {owner}/{repo}.
DELETE /teams/{team_id}/repos/{owner}/{repo} Remove a repository from a team by ID (legacy) · GitHub Remove a Repository from a Team (Legacy) #
Ask an LLM
“Can I remove a repo from a team via the numeric team ID route?”
“Is the ID-based remove-repository endpoint deprecated?”
Tell an agent destructive · confirm first
Using the legacy team ID route, detach the {owner}/{repo} repository from team {team_id}.
Via the deprecated endpoint, revoke numeric team {team_id} access to repository {owner}/{repo}.
GET /teams/{team_id}/teams List child teams by team ID (legacy) · GitHub List Child Teams (Legacy) #
Ask an LLM
“Can I list a team's sub-teams with only its numeric team ID?”
“Is the ID-based child teams list deprecated?”
Tell an agent
Using the legacy team ID route, list child teams of team {team_id}.
Via the deprecated endpoint, show teams nested beneath numeric team {team_id}.
GET /user/teams List my teams across all organizations · GitHub List Teams for the Authenticated User #
Ask an LLM
“Which teams am I on across every organization I belong to?”
“What scope does my token need to list my own teams?”
Tell an agent
List all the teams I belong to across my organizations.
Show my team memberships across every org, {per_page} per page.

Documentation

📖
Documentation
https://docs.github.com/en/rest/apps
📖
Documentation
https://docs.github.com/en/rest/codes-of-conduct/codes-of-conduct
📖
Documentation
https://docs.github.com/en/rest/emojis
📖
Documentation
https://docs.github.com/en/rest/gitignore
📖
Documentation
https://docs.github.com/en/rest/apps/installations
📖
Documentation
https://docs.github.com/en/rest/enterprise-admin
📖
Documentation
https://docs.github.com/en/rest/activity/events
📖
Documentation
https://docs.github.com/en/rest/orgs
📖
Documentation
https://docs.github.com/en/rest/rate-limit
📖
Documentation
https://docs.github.com/en/enterprise-cloud@latest/rest/scim
📖
Documentation
https://docs.github.com/en/rest/using-the-rest-api/getting-started-with-the-rest-api
📖
Documentation
https://docs.github.com/en/rest/teams
📖
Documentation
https://docs.github.com/en/rest/meta/meta
📖
Documentation
https://docs.github.com/en/rest/actions
📖
Documentation
https://docs.github.com/en/rest/branches
📖
Documentation
https://docs.github.com/en/rest/code-scanning
📖
Documentation
https://docs.github.com/en/rest/collaborators
📖
Documentation
https://docs.github.com/en/rest/dependabot
📖
Documentation
https://docs.github.com/en/rest/webhooks
📖
Documentation
https://docs.github.com/en/rest/pulls
📖
Documentation
https://docs.github.com/en/rest/git/tags
📖
Documentation
https://docs.github.com/en/rest/repos/autolinks
📖
Documentation
https://docs.github.com/en/rest/collaborators/invitations

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/github/refs/heads/main/openapi/github-teams-api-openapi.yml
⚙
AsyncAPI
https://raw.githubusercontent.com/api-evangelist/github/refs/heads/main/asyncapi/github-webhooks-asyncapi.yml

Other Resources

🔗
Reference
https://docs.github.com/en/webhooks/webhook-events-and-payloads

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/github-teams-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

github-teams-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  version: 1.1.4
  title: GitHub v3 REST Teams API
  description: GitHub's v3 REST API.
  license:
    name: MIT
    url: https://spdx.org/licenses/MIT
  termsOfService: https://docs.github.com/articles/github-terms-of-service
  contact:
    name: Support
    url: https://support.github.com/contact?tags=dotcom-rest-api
  x-github-plan: ghes
  x-github-release: 3.9
servers:
- url: '{protocol}://{hostname}/api/v3'
  variables:
    hostname:
      description: Self-hosted Enterprise Server hostname
      default: HOSTNAME
    protocol:
      description: Self-hosted Enterprise Server protocol
      default: http
tags:


# --- truncated at 32 KB (219 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/github/refs/heads/main/openapi/github-teams-api-openapi.yml