Create a milestone
POST
/repos/{owner}/{repo}/milestones
const url = 'https://gitea.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.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