Skip to main content
POST
Create a new milestone

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
title
string
required

Milestone title

Required string length: 3 - 255
status
string
required

Milestone status ID

slug
string
required

URL-friendly milestone identifier

Required string length: 3 - 255
Pattern: ^[a-z0-9]+(?:-[a-z0-9]+)*$
body
string

Milestone description/body content

is_public
boolean

Whether milestone should be publicly visible

project_id
string | null

ID of the project this milestone belongs to

label_ids
string[]

Array of label IDs to attach to the milestone

attachments
object[]

Array of attachments to include

Response

Milestone created successfully

id
string

Unique milestone identifier

title
string

Milestone title

body
string

Milestone description/body content (HTML formatted)

slug
string

URL-friendly milestone identifier

status
string

Current milestone status

stage
string

Current milestone stage

is_public
boolean

Whether milestone is publicly visible

upvote_count
integer

Number of votes for this milestone

project
object
labels
object[]
attachments
object[]
created_at
string<date-time>

When the milestone was created

updated_at
string<date-time>

When the milestone was last updated