---
title: "List a repository's teams"
method: GET
path: "/repos/{owner}/{repo}/teams"
tags: ["repository"]
---

# List a repository's teams

`GET /repos/{owner}/{repo}/teams`

## Request

- Base URL: `https://demo.gitea.com/api/v1`
- URL: `https://demo.gitea.com/api/v1/repos/{owner}/{repo}/teams`
- Auth: one of:
  - HTTP basic
  - API key in query parameter `token`
  - API key in query parameter `access_token`
  - API key in header `Authorization`
  - API key in query parameter `sudo`
  - API key in header `Sudo`
  - API key in header `X-GITEA-OTP`
- TypeScript: <https://skmtc.dev/gitea/apis/gitea-api/docs/repos/:owner/:repo/teams/get.ts> (a function with typed inputs; its response is checked against the schema)

## Path parameters

- `owner` string, required
- `repo` string, required

## Response `200`

TeamList

- Team[]
  - `can_create_org_repo` boolean: Whether the team can create repositories in the organization
  - `description` string: The description of the team
  - `id` integer: The unique identifier of the team
  - `includes_all_repositories` boolean: Whether the team has access to all repositories in the organization
  - `name` string: The name of the team
  - `organization` Organization: Organization represents an organization
    - `avatar_url` string: The URL of the organization's avatar
    - `description` string: The description of the organization
    - `email` string: The email address of the organization
    - `full_name` string: The full display name of the organization
    - `id` integer: The unique identifier of the organization
    - `location` string: The location of the organization
    - `name` string: The name of the organization
    - `repo_admin_change_team_access` boolean: Whether repository administrators can change team access
    - `username` string: username of the organization deprecated
    - `visibility` 'public' | 'limited' | 'private': The visibility level of the organization (public, limited, private)
    - `website` string: The website URL of the organization
  - `permission` 'none' | 'read' | 'write' | 'admin' | 'owner'
  - `units` string[]: Deprecated: This variable should be replaced by UnitsMap and will be dropped in later versions.
  - `units_map` object
  - `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.

## Other responses

- `default`: APIError is error format response

## Changes

- **2026-10-28** `7ef50c4c527f`: 1 info
  - removed the non-success response with the status `404`

[Operation history](https://skmtc.dev/gitea/apis/gitea-api/changes/repos/:owner/:repo/teams/get.md)

---

[API](https://skmtc.dev/gitea/apis/gitea-api.md) - [All operations](https://skmtc.dev/gitea/apis/gitea-api/llms.txt) - [OpenAPI document](https://skmtc.dev/gitea/apis/gitea-api/revisions/7ef50c4c527f?raw)