---
title: "Create a job milestone"
method: POST
path: "/jobs/{job_id}/job_milestones"
tags: ["Jobs", "Job Milestones"]
---

# Create a job milestone

`POST /jobs/{job_id}/job_milestones`

## Request

- Base URL: `https://api.streamtime.net/v2`
- URL: `https://api.streamtime.net/v2/jobs/{job_id}/job_milestones`
- Auth: HTTP bearer

Creates a new milestone for a job.

## Path parameters

- `job_id` integer, required

## Request body

- JobMilestone: A milestone date within a job of when something is happening or needs to be completed by
  - `id` integer: Job Milestone ID
  - `jobId` integer: Job ID
  - `jobItemId` integer, nullable: Job Item ID
  - `name` string: Name of the milestone
  - `date` string, date, nullable: Date of the milestone

## Response `200`

Job milestone created.

- JobMilestone: A milestone date within a job of when something is happening or needs to be completed by
  - `id` integer: Job Milestone ID
  - `jobId` integer: Job ID
  - `jobItemId` integer, nullable: Job Item ID
  - `name` string: Name of the milestone
  - `date` string, date, nullable: Date of the milestone

---

[API](https://skmtc.dev/streamtime/apis/public-api.md) · [All operations](https://skmtc.dev/streamtime/apis/public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/streamtime/apis/public-api/revisions/cda8d1405534?raw)