Sign in

v5

latestSwagger 2.0MIT2026-08-03485217850.7 KB
organization

Create a team

post/orgs/{org}/teams

Path parameters

orgstring required

name of the organization

Request body

can_create_org_repoboolean

Whether the team can create repositories in the organization

descriptionstring

The description of the team

includes_all_repositoriesboolean

Whether the team has access to all repositories in the organization

namestring required
permission'read' | 'write' | 'admin'
unitsstring[]

Deprecated: This variable should be replaced by UnitsMap and will be dropped in later versions.

units_mapobject
visibility'public' | 'limited' | 'private'

Team visibility within the organization. Defaults to "private".

Example request

{
  "units": [
    "repo.actions",
    "repo.packages",
    "repo.code",
    "repo.issues",
    "repo.ext_issues",
    "repo.wiki",
    "repo.pulls",
    "repo.releases",
    "repo.projects",
    "repo.ext_wiki"
  ],
  "units_map": {
    "repo.actions": "read",
    "repo.code": "read",
    "repo.ext_issues": "none",
    "repo.ext_wiki": "none",
    "repo.issues": "write",
    "repo.packages": "read",
    "repo.projects": "none",
    "repo.pulls": "owner",
    "repo.releases": "none",
    "repo.wiki": "admin"
  }
}

Response

Team

can_create_org_repoboolean

Whether the team can create repositories in the organization

descriptionstring

The description of the team

idinteger

The unique identifier of the team

includes_all_repositoriesboolean

Whether the team has access to all repositories in the organization

namestring

The name of the team

permission'none' | 'read' | 'write' | 'admin' | 'owner'
unitsstring[]

Deprecated: This variable should be replaced by UnitsMap and will be dropped in later versions.

units_mapobject
visibility'public' | 'limited' | 'private'

Team visibility within the organization. "private" teams are only listable by members and org owners; "limited" teams are listable by any organization member; "public" teams are listable by any signed-in user.

Example response

{
  "units": [
    "repo.code",
    "repo.issues",
    "repo.ext_issues",
    "repo.wiki",
    "repo.pulls",
    "repo.releases",
    "repo.projects",
    "repo.ext_wiki"
  ],
  "units_map": {
    "repo.code": "read",
    "repo.ext_issues": "none",
    "repo.ext_wiki": "none",
    "repo.issues": "write",
    "repo.projects": "none",
    "repo.pulls": "owner",
    "repo.releases": "none",
    "repo.wiki": "admin"
  }
}