Create a milestone
POST
/repos/{owner}/{repo}/milestones
const url = 'https://gitea.example.com/api/v1/repos/example/example/milestones';const options = { method: 'POST', headers: {Authorization: 'Basic <credentials>', 'Content-Type': 'application/json'}, body: '{"description":"example","due_on":"2026-04-15T12:00:00Z","state":"open","title":"example"}'};
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}curl --request POST \ --url https://gitea.example.com/api/v1/repos/example/example/milestones \ --header 'Authorization: Basic <credentials>' \ --header 'Content-Type: application/json' \ --data '{ "description": "example", "due_on": "2026-04-15T12:00:00Z", "state": "open", "title": "example" }'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 typeapplication/json
CreateMilestoneOption options for creating a milestone
object
description
string
due_on
string format: date-time
state
string
title
string
Responses
Section titled “Responses”Milestone
Media typeapplication/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
Examplegenerated
{ "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"}APINotFound is a not found empty response
Media typeapplication/json