Skip to main content
GitHub Docs
Version:
Free, Pro, & Team
Search GitHub Docs
REST API
/
Teams
All products
REST API
API Version:
2022-11-28 (latest)
Quickstart
Overview
About GitHub's APIs
Resources in the REST API
API Versions
Media types
Authenticating
Keeping API credentials secure
Troubleshooting
Libraries
OpenAPI description
Issue event types
GitHub event types
Endpoints for GitHub App installation tokens
Endpoints for GitHub App user tokens
Endpoints for fine-grained PATs
Permissions for GitHub Apps
Permissions for fine-grained PATs
Breaking changes
Guides
Using the API
Script with JavaScript
Discover resources for a user
Delivering deployments
Rendering data as graphs
Working with comments
Pagination
Building a CI server
Best practices
Get started - Git database
Get started - Checks
Encrypt secrets
Actions
Artifacts
Cache
OIDC
Permissions
Secrets
Self-hosted runners
Variables
Workflow jobs
Workflow runs
Workflows
Activity
Events
Feeds
Notifications
Starring
Watching
Apps
GitHub Apps
Installations
Marketplace
OAuth Authorizations
Webhooks
Billing
Billing
Branches
Branches
Protected branches
Checks
Check Runs
Check Suites
Codes of conduct
Codes of conduct
Code Scanning
Code Scanning
Codespaces
Codespaces
Organizations
Organization secrets
Machines
Repository secrets
User secrets
Collaborators
Collaborators
Invitations
Commits
Commits
Commit comments
Commit statuses
Copilot
Copilot for Business
Dependabot
Alerts
Secrets
Dependency Graph
Dependency review
Dependency submission
Software bill of materials (SBOM)
Deploy keys
Deploy keys
Deployments
Deployment branch policies
Deployments
Environments
Protection rules
Deployment statuses
Emojis
Emojis
Gists
Gists
Comments
Git database
Blobs
Commits
References
Tags
Trees
Gitignore
Gitignore
Interactions
Organization
Repository
User
Issues
Issues
Assignees
Comments
Events
Labels
Milestones
Timeline
Licenses
Licenses
Markdown
Markdown
Meta
Meta
Metrics
Community
Statistics
Traffic
Migrations
Organizations
Source imports
Users
Organizations
Blocking users
Members
Organizations
Outside Collaborators
Personal access tokens
Rules
Security Managers
Webhooks
Packages
Packages
Pages
Pages
Projects (classic)
Boards
Cards
Collaborators
Columns
Pulls
Pulls
Review comments
Review requests
Reviews
Rate limit
Rate limit
Reactions
Reactions
Releases
Releases
Release Assets
Repositories
Autolinks
Contents
Forks
Repositories
Rules
Tags
Search
Search
Secret scanning
Secret scanning
Security advisories
Global security advisories
Repository security advisories
Teams
Teams
Discussion comments
Discussions
Members
Users
Users
Blocking users
Emails
Followers
GPG Keys
Git SSH Keys
SSH signing keys
Social accounts
Repository webhooks
Repository Webhook Configuration
Repository Webhook Deliveries
Repository Webhooks
Classroom
Classroom
The REST API is now versioned.
For more information, see "
About API versioning
."
REST API
/
Teams
Teams
Use the REST API to create and manage teams in your GitHub organization.
Teams
List teams
Create a team
Get a team by name
Update a team
Delete a team
List team projects
Check team permissions for a project
Add or update team project permissions
Remove a project from a team
List team repositories
Check team permissions for a repository
Add or update team repository permissions
Remove a repository from a team
List child teams
Get a team (Legacy)
Update a team (Legacy)
Delete a team (Legacy)
List team projects (Legacy)
Check team permissions for a project (Legacy)
Add or update team project permissions (Legacy)
Remove a project from a team (Legacy)
List team repositories (Legacy)
Check team permissions for a repository (Legacy)
Add or update team repository permissions (Legacy)
Remove a repository from a team (Legacy)
List child teams (Legacy)
List teams for the authenticated user
Discussion comments
List discussion comments
Create a discussion comment
Get a discussion comment
Update a discussion comment
Delete a discussion comment
List discussion comments (Legacy)
Create a discussion comment (Legacy)
Get a discussion comment (Legacy)
Update a discussion comment (Legacy)
Delete a discussion comment (Legacy)
Discussions
List discussions
Create a discussion
Get a discussion
Update a discussion
Delete a discussion
List discussions (Legacy)
Create a discussion (Legacy)
Get a discussion (Legacy)
Update a discussion (Legacy)
Delete a discussion (Legacy)
Members
List pending team invitations
List team members
Get team membership for a user
Add or update team membership for a user
Remove team membership for a user
List pending team invitations (Legacy)
List team members (Legacy)
Get team member (Legacy)
Add team member (Legacy)
Remove team member (Legacy)
Get team membership for a user (Legacy)
Add or update team membership for a user (Legacy)
Remove team membership for a user (Legacy)