---
title: "Merge a pull request"
method: POST
path: "/repos/{owner}/{repo}/pulls/{index}/merge"
tags: ["repository"]
---

# Merge a pull request

`POST /repos/{owner}/{repo}/pulls/{index}/merge`

## Request

- Base URL: `https://demo.gitea.com/api/v1`
- URL: `https://demo.gitea.com/api/v1/repos/{owner}/{repo}/pulls/{index}/merge`
- 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/pulls/:index/merge/post.ts> (a function with typed inputs; its response is checked against the schema)

## Path parameters

- `owner` string, required
- `repo` string, required
- `index` integer, required

## Request body

- MergePullRequestOption: MergePullRequestForm form for merging Pull Request
  - `delete_branch_after_merge` boolean
  - `do` 'merge' | 'rebase' | 'rebase-merge' | 'squash' | 'fast-forward-only' | 'manually-merged', required
  - `force_merge` boolean
  - `head_commit_id` string
  - `merge_commit_id` string
  - `merge_message_field` string
  - `merge_title_field` string
  - `merge_when_checks_succeed` boolean

## Response `200`

APIEmpty is an empty response

## Other responses

- `default`: APIError is error format response

## Changes

- **2026-10-28** `7ef50c4c527f`: 5 info
  - removed the non-success response with the status `403`
  - removed the non-success response with the status `404`
  - removed the non-success response with the status `405`
  - removed the non-success response with the status `409`
  - …1 more
- **2026-07-13** `4df6be504c96`: 1 info
  - added the non-success response with the status `403`

[Operation history](https://skmtc.dev/gitea/apis/gitea-api/changes/repos/:owner/:repo/pulls/:index/merge/post.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/b8e58c32921d?raw)