20. POST /repos/{owner}/{repo}/forks — создать форк репозитория

Описание

Создает форк указанного репозитория под аутентифицированным пользователем или в указанной организации.

Параметры URL

Тело запроса

Передается в формате JSON. Все поля необязательные.

{
  "name": "my-fork",
  "description": "Форк проекта для доработки",
  "organization": "my-org"
}

📌 Если поле organization не указано, форк создается в личном аккаунте текущего пользователя.

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

curl -X POST "https://api.gitverse.ru/repos/awesome-org/project-x/forks" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Accept: application/vnd.gitverse.object+json;version=latest" \
  -d '{
    "organization": "my-team"
  }'

Ответ (200 OK)

Возвращается объект репозитория ($ref: "#/definitions/response.Repository").

Пример:

{
  "id": 12345,
  "name": "project-x",
  "full_name": "my-team/project-x",
  "private": false,
  "fork": true,
  "owner": {
    "login": "my-team",
    "id": 987,
    "avatar_url": "https://gitverse.ru/avatars/my-team.png"
  },
  "html_url": "https://gitverse.ru/my-team/project-x",
  "created_at": "2025-04-05T10:00:00Z",
  "default_branch": "main",
  "parent": {
    "full_name": "awesome-org/project-x",
    "owner": { "login": "awesome-org" }
  }
}

Формат ответа

application/vnd.gitverse.object+json;version=latest

Поля ответа (response.Repository)

Вложенные объекты

owner (информация о владельце)

permissions (права текущего пользователя)

parent (исходный репозиторий, если это форк)

Содержит те же поля, что и основной объект репозитория (см. выше), включая owner, permissions, и т.д.
Например: parent.name, parent.full_name, parent.owner.login и пр.

template_repository (если репозиторий создан из шаблона)

Также содержит полный набор полей репозитория, как parent.

Коды ответа