Skip to content
forgit api docs

Create a milestone

POST
/repos/{owner}/{repo}/milestones

Authorizations

Section titled “ Authorizations ”

Parameters

Section titled “ Parameters ”

Path Parameters

Section titled “ Path Parameters ”
owner
required
string

Owner of the repo

repo
required
string

Name of the repo

Request Body

Section titled “ Request Body ”
Media type application/json

CreateMilestoneOption options for creating a milestone

object
description
string
due_on
string format: date-time
state
string
Allowed values: open closed
title
string

Responses

Section titled “ Responses ”

201

Section titled “ 201 ”

Milestone

Media type application/json

Milestone milestone is a collection of issues on one repository

object
closed_at
string format: date-time
closed_issues
integer format: int64
created_at
string format: date-time
description
string
due_on
string format: date-time
id
integer format: int64
open_issues
integer format: int64
state

StateType issue state type

string
title
string
updated_at
string format: date-time
Example generated 
{
  "closed_at": "2026-04-15T12:00:00Z",
  "closed_issues": 1,
  "created_at": "2026-04-15T12:00:00Z",
  "description": "example",
  "due_on": "2026-04-15T12:00:00Z",
  "id": 1,
  "open_issues": 1,
  "state": "example",
  "title": "example",
  "updated_at": "2026-04-15T12:00:00Z"
}

404

Section titled “ 404 ”

APINotFound is a not found error response

Media type application/json
object
errors
Array<string>
message
string
url
string
Example generated 
{
  "errors": [
    "example"
  ],
  "message": "example",
  "url": "example"
}