| GitVerse

1. `GET /orgs/{org}/teams` — получить список команд организации

Beta

Описание

Возвращает список всех команд в указанной организации, которые видны авторизованному пользователю.
Метод полезен для аудита доступов, интеграций с системами IAM и управления правами в рамках организации.

Параметры URL

Параметр	Обязательный	Описание
`org`	Да	Название организации

Параметры запроса

Параметр	Тип	Обязательный	Описание	По умолчанию
`page`	`integer`	Нет	Номер страницы пагинации	`1`
`per_page`	`integer`	Нет	Количество команд на странице (макс. 100)	`30`

Тело запроса

Данный метод не требует тела запроса.

Пример запроса

curl -X GET "https://api.gitverse.ru/orgs/my-organization/teams" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Accept: application/vnd.gitverse.object+json;version=1" \
  -G \
  --data-urlencode "page=1" \
  --data-urlencode "per_page=30"

Ответ (`200 OK`)

[
  {
    "id": 25,
    "name": "frontend-team",
    "description": "Команда фронтенд-разработчиков",
    "permission": "read",
    "permissionCode": "read",
    "permissionReleases": "write",
    "includesAllRepositories": false,
    "numMembers": 8,
    "numRepos": 12,
    "canCreateOrgRepo": false
  },
  {
    "id": 26,
    "name": "backend-team",
    "description": "Команда бэкенд-разработчиков",
    "permission": "write",
    "permissionCode": "write",
    "permissionReleases": "write",
    "includesAllRepositories": true,
    "numMembers": 10,
    "numRepos": 18,
    "canCreateOrgRepo": true
  }
]

Формат ответа:
application/vnd.gitverse.object+json;version=1

Поля ответа

Поле	Тип	Описание
`id`	`number`	Уникальный идентификатор команды
`name`	`string`	Название команды
`description`	`string \| null`	Описание команды (может быть `null`)
`permission`	`string`	Общий уровень доступа: `none`, `read`, `write`, `admin`, `owner`
`permissionCode`	`string`	Права на доступ к коду репозиториев
`permissionReleases`	`string`	Права на управление релизами
`permissionPackages`	`string`	Права на работу с пакетами
`permissionPulls`	`string`	Права на работу с pull-реквестами
`permissionActions`	`string`	Права на запуск и управление CI/CD-процессами
`includesAllRepositories`	`boolean`	`true` — команда имеет доступ ко всем репозиториям организации
`numMembers`	`number`	Количество участников в команде
`numRepos`	`number`	Количество репозиториев, к которым у команды есть доступ
`canCreateOrgRepo`	`boolean`	Может ли команда создавать новые репозитории в организации

Коды ответа

Код	Статус	Описание
`200`	OK	Список команд успешно получен
`400`	Bad Request	Один из параметров передан некорректно
`401`	Unauthorized	Не передан или невалиден токен авторизации
`403`	Forbidden	Нет прав на доступ к организации
`404`	Not Found	Организация не найдена

Команды 2. GET /orgs/{org}/teams/{team}/members — получить список участников команды

1. GET /orgs/{org}/teams — получить список команд организации