Project milestones are dated markers on a project — a launch, a review, a deadline — with a title, icon, color, an optional note and an optional assignee. They are shown on the project and on resource planning timelines.
Milestones are available only when the project milestones feature is enabled for the organization; otherwise the list is empty and other requests are rejected. Client users never see milestones.
Filter-only date: return milestones on or after this date.
The person responsible for this milestone, if any.
ID of the person responsible for this milestone; must be an active member of the project.
Filter-only date: return milestones on or before this date.
Color palette index this milestone is displayed with, the same palette as project colors. Returned as a string; defaults to the project's color on create.
Timestamp when this milestone was created.
The person who created this milestone.
The day this milestone falls on (YYYY-MM-DD, without time or time zone).
The icon identifier displayed for this milestone. The API accepts any string — the Productive UI uses identifiers from its icon set (e.g. icon-rocket-launch).
The unique identifier of this milestone.
Optional free-text note with more detail about this milestone.
The organization this milestone belongs to.
The project this milestone belongs to.
ID of the project this milestone belongs to.
A text search query to filter milestones by title.
The name of this milestone (e.g. Beta launch).
Timestamp when this milestone was last updated.