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

Parameters

Path Parameters

owner

required

string

Owner of the repo

repo

required

string

Name of the repo

Request Body

application/json

CreateMilestoneOption options for creating a milestone

object

description

Description provides details about the milestone

string

due_on

string format: date-time

state

string

Allowed values: open closed

title

Title is the title of the new milestone

string

Responses

201

Milestone

application/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 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 open StateOpen pr is opened closed StateClosed pr is closed

string

Allowed values: open closed

title

Title is the title of the milestone

string

updated_at

string format: date-time

Example

{
  "state": "open"
}

404

APINotFound is a not found empty response

application/json