---
title: "Pause the merge queue"
method: PUT
path: "/repos/{owner}/{repository}/merge-queue/pause"
tags: ["merge_queue"]
---

# Pause the merge queue

`PUT /repos/{owner}/{repository}/merge-queue/pause`

Pause the merge of the requested repository

## Path parameters

- `owner` string, required — The owner of the repository
- `repository` string, required — The name of the repository

## Request body

- MergeQueuePausePayload
  - `reason` string, required — The reason of the merge queue pause

## Response `200`

Successful Response

- MergeQueuePauseResponse
  - `paused` boolean, required — Whether the merge queue is currently paused
  - `reason` string, nullable — The reason of the merge queue pause
  - `paused_at` string, date-time, nullable — The date and time when the merge queue was paused

## Other responses

- `403` — Forbidden
- `404` — Not found
- `409` — Conflict
- `422` — Unprocessable entity

## Changes

- **2026-08-28** `b3864dcc206a` — 1 info
  - the endpoint scheme security `MergifyTokenBearerAuth` was added to the API
- **2026-08-13** `29857c6146cf` — 2 info
  - the endpoint scheme security `AdminApplicationKey` was added to the API
  - the endpoint scheme security `ApplicationAuth` was removed from the API

[Change history](https://skmtc.dev/mergify/apis/mergify-api/changes/repos/:owner/:repository/merge-queue/pause/put.md)

---

[API](https://skmtc.dev/mergify/apis/mergify-api.md) · [All operations](https://skmtc.dev/mergify/apis/mergify-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/mergify/mergify-api/revisions/de1a1de928a8/schema)