apicheats.dev Cheat sheet Raw .md
POST

Try POST /orgs/{org}/teams — GitHub API

GitHub playground

Create a team

Credentials

Kept in this tab only. Requests go through apicheats.dev's same-origin proxy straight to api.github.com; the proxy stores and logs nothing about them.

Headers

Path

Body application/json

8 body fields
  • name · required · string — The name of the team.
  • description · optional · string — The description of the team.
  • maintainers · optional · string[] — List GitHub usernames for organization members who will become team maintainers.
  • repo_names · optional · string[] — The full name (e.g., "organization-name/repository-name") of repositories to add the team to.
  • privacy · optional · string — The level of privacy this team should have. The options are: **For a non-nested team:** * `secret` - only visible to organization owners and members of this team. * `closed` - visible to all members of this organization. Default: `secret` **For a parent or child team:** * `closed` - visible to all members of this organization. Default for child team: `closed`
  • notification_setting · optional · string — The notification setting the team has chosen. The options are: * `notifications_enabled` - team members receive notifications when the team is @mentioned. * `notifications_disabled` - no one receives notifications. Default: `notifications_enabled`
  • parent_team_id · optional · integer — The ID of a team to set as the parent team.
  • parent_team_slug · optional · string — The slug of a team to set as the parent team. Ignored when `parent_team_id` is also provided.