---
title: "POST /api/repos/{namespace}/{repository}/milestones"
method: POST
path: "/api/repos/{namespace}/{repository}/milestones"
tags: ["issues"]
---

# POST /api/repos/{namespace}/{repository}/milestones

`POST /api/repos/{namespace}/{repository}/milestones`

## Path parameters

- `namespace` string, required
- `repository` string, required

## Request body

- CreateMilestoneRequest
  - `description` string, nullable — Description
  - `dueDate` string, date-time, nullable — Due date
  - `title` string, required — Title

## Response `200`

Milestone created

- MilestoneEntry
  - `closed` boolean, required — Whether milestone is closed
  - `closedIssues` integer, required — Amount of closed issues (completed, not planned)
  - `description` string, nullable — Description
  - `dueDate` string, date-time, nullable — Due date
  - `id` string, uuid, required — ID
  - `openIssues` integer, required — Amount of open issues (open, in progress)
  - `title` string, required — Title

## Other responses

- `400` — Invalid request
- `401` — Authentication required
- `403` — Insufficient permissions
- `404` — Repository not found or access denied

---

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