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

Описание

Возвращает список всех команд в указанной организации, которые видны авторизованному пользователю. Метод полезен для аудита доступов, интеграций с системами 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	Организация не найдена