---
sidebar_position: 23
description: "Manage organization teams and access"
---

# gt team

<!-- Generated by update_cli_docs.sh from the gitea/cli sources, do not edit. -->

Manage organization teams and access

## Synopsis

```text
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.
```

```
gt team [flags]
```

## Options

```
  -h, --help   help for team
```

## Options inherited from parent commands

```
      --cwd directory       Working directory for repository discovery
      --debug               Log the method, URL, status, and duration of each HTTP request to stderr
      --host URL            Gitea instance URL, including any base path
      --interactive         Allow prompts with machine output
  -q, --jq expression       Filter JSON output using a jq expression; implies --json
      --json fields[="*"]   Output JSON with the specified comma-separated fields, or all fields
      --no-input            Disable prompts and implicit editor/browser interactions
      --remote remote       Git remote used for repository discovery
  -R, --repo OWNER/REPO     Select a repository as OWNER/REPO or URL
      --sudo user           Perform API requests as this user (requires an administrator account)
      --user name           Account name on the selected instance
  -y, --yes                 Accept confirmations without prompting
```

## SEE ALSO

* [gt](../index.md): Work with Gitea from your terminal
* [gt team create](../team/create.md): Create a team
* [gt team delete](../team/delete.md): Delete a team
* [gt team edit](../team/edit.md): Edit a team
* [gt team list](../team/list.md): List organization teams
* [gt team member](../team/member/index.md): Manage team members
* [gt team repo](../team/repo/index.md): Manage team repository access
* [gt team view](../team/view.md): View a team