---
title: "Delete a scheduled freeze"
method: POST
path: "/repos/{owner}/{repository}/scheduled_freeze/{freeze_id}/delete"
tags: ["scheduled_freeze"]
---

# Delete a scheduled freeze

`POST /repos/{owner}/{repository}/scheduled_freeze/{freeze_id}/delete`

## Request

- Base URL: `https://api.mergify.com/v1`
- URL: `https://api.mergify.com/v1/repos/{owner}/{repository}/scheduled_freeze/{freeze_id}/delete`
- Auth: one of:
  - HTTP bearer
  - HTTP bearer
  - HTTP bearer

Delete an existing scheduled freeze on the repository specified in the path

## Path parameters

- `freeze_id` string, uuid, required: The scheduled freeze `id`
- `repository` string, required: The name of the repository
- `owner` string, required: The owner of the repository

## Request body

- DeleteScheduledFreezePayload
  - `delete_reason` string, required: The reason for the deletion

## Response `204`

Successful Response

## Other responses

- `403`: Forbidden
- `404`: The scheduled freeze with the given id does not exist
- `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

[Operation history](https://skmtc.dev/mergify/apis/mergify-api/changes/repos/:owner/:repository/scheduled_freeze/:freeze_id/delete/post.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.dev/mergify/apis/mergify-api/revisions/00b8f4a31190?raw)