Skip to content
forgit api docs

Update a milestone

PATCH
/repos/{owner}/{repo}/milestones/{id}

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

id
required
integer format: int64

The milestone to edit, identified by ID and if not available by name

Request Body

Section titled “ Request Body ”
Media type application/json

EditMilestoneOption options for editing a milestone

object
description
string
due_on
string format: date-time
state
string
title
string
Example generated 
{
  "description": "example",
  "due_on": "2026-04-15T12:00:00Z",
  "state": "example",
  "title": "example"
}

Responses

Section titled “ Responses ”

200

Section titled “ 200 ”

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"
}