organization

Create a team

Changed on Oct 28, 2026

post/orgs/{org}/teams

Request

Base URL
https://demo.gitea.com/api/v1
Auth
- HTTP basic
- or API key in query parameter token
- or API key in query parameter access_token
- or API key in header Authorization
- or API key in query parameter sudo
- or API key in header Sudo
- or API key in header X-GITEA-OTP
TypeScript
https://skmtc.dev/gitea/apis/gitea-api/docs/orgs/:org/teams/post.ts
A function with typed inputs. Its response is checked against the schema.

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'

All units have this 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'