Skip to main content

Create a milestones

Create a milestones.

Parameters​

title
string
Title of the milestone.
description
string
Description of the milestone.
start_date
string
The start date of the milestone in format `Y-m-d`. Must be before the due date.
due_date
string
The due date of the milestone in format `Y-m-d`. Must be after the start date.
visibility
enum
Visibility of the milestone. One of private, internal, shared.
role
enum
Only when visibility is internal. Used as the default role for all team members. If a user has a directly attached role, it will override this one. One of milestone_admin, milestone_manager, milestone_viewer.
folder
string
Unique identifier for the folder in which the milestone will be created.

Returns​

Returns the created milestone object. Throws an error if some parameters are not valid.

post
/api/milestones
curl -X POST https://{workspace}.kitchen.co/api/milestones \
    -H 'Content-Type: application/json' \
    -H 'Accept: application/json' \
    -H 'X-Requested-With: XMLHttpRequest' \
    -H 'Authorization: Bearer {API_KEY}'
Response
{
  "archived_at": null,
  "closed_at": null,
  "created_at": "2024-08-20T09:34:32+00:00",
  "description": "Aperiam earum saepe consequuntur aut.",
  "due_date": "2024-08-27T00:00:00+00:00",
  "id": "mst_9fbd4636814ff5d5ae7a23f0",
  "start_date": "2024-08-20T00:00:00+00:00",
  "title": "Adipisci doloribus eos possimus reprehenderit.",
  "updated_at": "2024-08-20T09:34:32+00:00",
  "visibility": "internal"
}