---
title: "Create a freeze period"
method: POST
path: "/api/v4/projects/{id}/freeze_periods"
tags: ["freeze_periods"]
---

# Create a freeze period

`POST /api/v4/projects/{id}/freeze_periods`

## Request

- Base URL: `https://gitlab.com`
- URL: `https://gitlab.com/api/v4/projects/{id}/freeze_periods`
- Auth: none declared

Creates a freeze period for a specified project. You must have the Maintainer or Owner role for the project.

## Path parameters

- `id` string, required

## Request body

- PostApiV4ProjectsIdFreezePeriods: Create a freeze period
  - `freeze_start` string, required: Start of the freeze period in cron format.
  - `freeze_end` string, required: End of the freeze period in cron format
  - `cron_timezone` string: The time zone for the cron fields, defaults to UTC if not provided

## Response `201`

Create a freeze period

- APIEntitiesFreezePeriod: API_Entities_FreezePeriod model
  - `id` integer, required
  - `freeze_start` string, required
  - `freeze_end` string, required
  - `cron_timezone` string, required
  - `created_at` string, date-time, required
  - `updated_at` string, date-time, required

## Other responses

- `400`: Bad request
- `401`: Unauthorized

---

[API](https://skmtc.dev/gitlab/apis/gitlab-api.md) - [All operations](https://skmtc.dev/gitlab/apis/gitlab-api/llms.txt) - [OpenAPI document](https://skmtc.dev/gitlab/apis/gitlab-api/revisions/b234947ef3f2?raw)