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
Description provides details about the milestone
string
due_on
Deadline is the due date for the milestone
string format: date-time
state
State indicates the initial state of the milestone
string
title
Title is the title of the new milestone
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
ClosedIssues is the number of closed issues in this milestone
integer format: int64
created_at
string format: date-time
description
Description provides details about the milestone
string
due_on
string format: date-time
id
ID is the unique identifier for the milestone
integer format: int64
open_issues
OpenIssues is the number of open issues in this milestone
integer format: int64
state
State indicates if the milestone is open or closed
string
title
Title is the title of the milestone
string
updated_at
string format: date-time
Example
{ "state": "open"}APINotFound is a not found empty response