---
name: "gt-team"
section: "1"
platform: "linux"
package: "gitea-cli"
version: "1.0.0-1"
release: "Arch Linux 2026-11-07"
platforms: ["linux"]
url: "https://carta.tech/man/gt-team"
---

# gt-team(1)

Manage organization teams and access

## NAME

gt-team - Manage organization teams and access

## SYNOPSIS

**gt team \[flags\]**

## DESCRIPTION

Manage the teams of an organization: what they may do in its repositories, who belongs to them, and which repositories they can reach.

In JSON, access is the team's effective access as the text views show it, such as write or "write (code, issues, pulls)"; permission is the team-wide level Gitea reports, which is none for a team that grants its access per unit.

## OPTIONS

**-h**, **--help**\[=false\]\
 	help for team

## OPTIONS INHERITED FROM PARENT COMMANDS

**--debug**\[=false\]\
 	Log the method, URL, status, and duration of each HTTP request to stderr

**--host**=""\
 	Gitea instance **URL**, including any base path

**--interactive**\[=false\]\
 	Allow prompts with machine output

**--no-input**\[=false\]\
 	Disable prompts and implicit editor/browser interactions

**--sudo**=""\
 	Perform API requests as this **user** (requires an administrator account)

**--user**=""\
 	Account **name** on the selected instance

## SEE ALSO

**[gt(1)](/man/gt/1.md)**, **[gt-team-create(1)](/man/gt-team-create/1.md)**, **[gt-team-delete(1)](/man/gt-team-delete/1.md)**, **[gt-team-edit(1)](/man/gt-team-edit/1.md)**, **[gt-team-list(1)](/man/gt-team-list/1.md)**, **[gt-team-member(1)](/man/gt-team-member/1.md)**, **[gt-team-repo(1)](/man/gt-team-repo/1.md)**, **[gt-team-view(1)](/man/gt-team-view/1.md)**