| GitVerse

6. `PATCH /repos/{owner}/{repo}/pulls/{pull_number}` — pедактирование запроса на слияние

Описание

Обновляет метаданные существующего запроса на слияние: заголовок, описание, целевую ветку и другие параметры. Не влияет на содержимое коммитов или файлов — только на атрибуты самого PR.

Параметры URL

Параметр	Тип	Обязательный	Описание
`owner`	string	Да	Владелец репозитория (пользователь или организация)
`repo`	string	Да	Название репозитория
`pull_number`	integer	Да	Номер pull request в репозитории

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

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

Тело запроса

Формат: application/json
Поля являются опциональными — можно передавать только те, которые нужно изменить.

{
  "title": "Новый заголовок",
  "body": "Обновленное описание PR",
  "state": "open" | "closed",
  "base": "main",
  "maintainer_can_modify": true
}

Поле	Тип	Обязательный	Возможные значения / Описание
`title`	string	Нет	Новый заголовок PR
`body`	string	Нет	Новое описание (тело) PR
`state`	string	Нет	`open` — оставляет PR открытым, `closed` — закрывает его
`base`	string	Нет	Имя новой целевой ветки (в которую сливается PR)
`maintainer_can_modify`	boolean	Нет	Разрешить мейнтейнерам репозитория изменять ветку автора

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

curl -X PATCH "https://api.gitverse.ru/repos/gitverse/example-repo/pulls/42" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Accept: application/vnd.gitverse.object+json;version=1" \
  -H "Content-Type: application/json" \
  -d '{
        "title": "feat(auth): add OAuth2 support",
        "body": "Implements OAuth2 login flow with external providers.",
        "base": "main"
      }'

Ответ (200 OK)

Пример JSON-ответа:

{
  "id": 12345,
  "number": 42,
  "state": "open",
  "title": "feat(auth): add OAuth2 support",
  "body": "Implements OAuth2 login flow with external providers.",
  "created_at": "2025-10-10T08:30:00Z",
  "updated_at": "2025-10-23T15:45:00Z",
  "closed_at": null,
  "merged_at": null,
  "merged": false,
  "mergeable": true,
  "is_draft": false,
  "locked": false,
  "maintainer_can_modify": true,
  "merge_commit_sha": "a1b2c3d4e5f6789012345678901234567890abcd",
  "html_url": "https://gitverse.ru/gitverse/example-repo/pull/42",
  "diff_url": "https://gitverse.ru/gitverse/example-repo/pull/42.diff",
  "patch_url": "https://gitverse.ru/gitverse/example-repo/pull/42.patch",
  "url": "https://api.gitverse.ru/repos/gitverse/example-repo/pulls/42",
  "comments": 5,
  "user": {
    "login": "alice",
    "id": 789,
    "avatar_url": "https://gitverse.ru/avatars/789.png",
    "html_url": "https://gitverse.ru/alice"
  },
  "assignees": [],
  "labels": [],
  "milestone": null,
  "requested_reviewers": [],
  "requested_teams": [],
  "base": {
    "label": "gitverse:main",
    "ref": "main",
    "sha": "f00dcafe1234567890abcdef1234567890abcdef",
    "repo": {
      "id": 1111,
      "name": "example-repo",
      "full_name": "gitverse/example-repo",
      "private": false,
      "owner": {
        "login": "gitverse",
        "id": 100,
        "avatar_url": "https://gitverse.ru/avatars/100.png",
        "html_url": "https://gitverse.ru/gitverse"
      },
      "html_url": "https://gitverse.ru/gitverse/example-repo",
      "description": "An example repository",
      "fork": false,
      "url": "https://api.gitverse.ru/repos/gitverse/example-repo",
      "ssh_url": "git@gitverse.ru:gitverse/example-repo.git",
      "clone_url": "https://gitverse.ru/gitverse/example-repo.git",
      "default_branch": "main"
    },
    "repo_id": 1111
  },
  "head": {
    "label": "alice:feature/auth",
    "ref": "feature/auth",
    "sha": "a1b2c3d4e5f6789012345678901234567890abcd",
    "repo": {
      "id": 1111,
      "name": "example-repo",
      "full_name": "gitverse/example-repo",
      "private": false,
      "owner": {
        "login": "gitverse",
        "id": 100,
        "avatar_url": "https://gitverse.ru/avatars/100.png",
        "html_url": "https://gitverse.ru/gitverse"
      },
      "html_url": "https://gitverse.ru/gitverse/example-repo",
      "description": "An example repository",
      "fork": false,
      "url": "https://api.gitverse.ru/repos/gitverse/example-repo",
      "ssh_url": "git@gitverse.ru:gitverse/example-repo.git",
      "clone_url": "https://gitverse.ru/gitverse/example-repo.git",
      "default_branch": "main"
    },
    "repo_id": 1111
  }
}

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

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

Поля ответа

Поле	Тип	Описание
`id`	integer	Уникальный идентификатор pull request
`number`	integer	Номер PR в репозитории
`state`	string	Состояние: `open`, `closed`
`title`	string	Заголовок PR
`body`	string	Описание (тело) PR
`created_at`	string	Дата создания
`updated_at`	string	Дата последнего обновления
`closed_at`	string	null
`merged_at`	string	null
`merged`	boolean	Был ли PR слит
`mergeable`	boolean	Можно ли слить без конфликтов
`is_draft`	boolean	Является ли черновиком
`locked`	boolean	Заблокирован ли от комментариев
`maintainer_can_modify`	boolean	Могут ли мейнтейнеры изменять ветку автора
`merge_commit_sha`	string	null
`html_url`	string	Ссылка на PR в веб-интерфейсе
`diff_url` / `patch_url`	string	Ссылки на diff и patch
`url`	string	API-ссылка на PR
`comments`	integer	Количество комментариев
`user`	object	Автор PR
`assignees`	array	Назначенные участники
`labels`	array	Метки
`milestone`	object	null
`requested_reviewers`	array	Запрошенные ревьюеры
`requested_teams`	array	Запрошенные команды
`base`	object	Целевая ветка и репозиторий
`head`	object	Исходная ветка и репозиторий

Подполе `user`, `assignees[i]`, `merged_by`

Поле	Тип	Описание
`login`	string	Логин пользователя
`id`	integer	Уникальный идентификатор
`avatar_url`	string	Ссылка на аватар
`html_url`	string	Ссылка на профиль

Подполе `labels[i]`

Поле	Тип	Описание
`id`	integer	Идентификатор метки
`name`	string	Название
`color`	string	Цвет (в HEX без `#`)
`description`	string	Описание
`exclusive`	boolean	Является ли исключающей
`is_archived`	boolean	Архивирована ли
`url`	string	API-ссылка на метку

Подполе `milestone`

Поле	Тип	Описание
`id`	integer	Идентификатор вехи
`title`	string	Название
`description`	string	Описание
`state`	string	Состояние (`open` / `closed`)
`due_on`	string	Срок выполнения
`created_at`	string	Дата создания
`updated_at`	string	Дата обновления
`closed_at`	string	null
`open_issues`	integer	Открытые задачи
`closed_issues`	integer	Закрытые задачи

Подполя `base` и `head`

Поле	Тип	Описание
`label`	string	В формате `owner:ref`
`ref`	string	Имя ветки
`sha`	string	SHA последнего коммита в ветке
`repo`	object	Информация о репозитории
`repo_id`	integer	Идентификатор репозитория

Коды ответа

Код	Статус	Описание
200	OK	Запрос на слияние успешно обновлен
400	Bad Request	Некорректные данные в теле запроса
401	Unauthorized	Токен отсутствует или недействителен
403	Forbidden	Недостаточно прав для редактирования PR
404	Not Found	Репозиторий или запрос на слияние не найден
500	Internal Server Error	Внутренняя ошибка сервера

5. PUT /repos/{owner}/{repo}/pulls/{pull_number}/update-branch — обновить ветку запроса на слияние 7. GET /repos/{owner}/{repo}/pulls — показать список всех запросов на слияние

6. PATCH /repos/{owner}/{repo}/pulls/{pull_number} — pедактирование запроса на слияние