---
title: "Update job item"
method: PUT
path: "/job_items/{job_item_id}"
tags: ["Job Items"]
---

# Update job item

`PUT /job_items/{job_item_id}`

## Request

- Base URL: `https://api.streamtime.net/v2`
- URL: `https://api.streamtime.net/v2/job_items/{job_item_id}`
- Auth: HTTP bearer

## Path parameters

- `job_item_id` integer, required

## Request body

- JobItem: A job item within a job
  - `id` integer: Job item ID
  - `jobId` integer: Parent job ID
  - `jobPhaseId` integer, nullable: Job phase ID
  - `jobItemStatus` JobItemStatus: Status of a Job item.
    - `id` 1 | 2 | 3 | 4: Job Item Status ID (1=Planning, 4=Scheduled, 2=Complete, 3=Deleted)
    - `name` string
  - `name` string: Job item name
  - `description` string, nullable: Job item description
  - `sellRate` number, float, nullable: Explicit sell rate in job currency (if provided)
  - `costingMethod` CostingMethod
    - `id` 1 | 2 | 3 | 4: Consting Method ID (1=Item, 2=People, 3=Fixed Price Calculated Sell, 4=Fixed Price User Sell)
    - `name` string
  - `isBillable` boolean: Is this job item billable
  - `totalScheduledUsers` integer, nullable: Total scheduled users for the item
  - `totalJobItemRoles` integer, nullable: Total job item roles
  - `timeAllocationMethod` TimeAllocationMethod: How the time of an item is allocated, whether as a bucket that is shared amongst all users or individually assigned to each user.
    - `id` 1 | 2: Time Allocation Method ID (1=Item, 2=People)
    - `name` string
  - `totalPlannedMinutes` integer, nullable: Total planned minutes for the item
  - `totalIncompleteMinutes` integer, nullable: Total incomplete minutes for the item
  - `totalLoggedMinutes` integer, nullable: Total logged minutes for the item
  - `jobCurrencySellRate` number, float, nullable: Sell rate in job currency (per hour)
  - `jobCurrencyTotalIncompleteTimeExTax` number, float, nullable: Total incomplete time ex tax (job currency)
  - `jobCurrencyTotalPlannedTimeExTax` number, float, nullable: Total planned time ex tax (job currency)
  - `jobCurrencyTotalLoggedTimeExTax` number, float, nullable: Total logged time ex tax (job currency)
  - `jobCurrencyTotalLoggedTimeCostExTax` number, float, nullable: Total logged time cost ex tax (job currency)
  - `jobCurrencyTotalAmountInvoicedExTax` number, float, nullable: Total amount invoiced ex tax for this job item (job currency)
  - `jobCurrencyTotalDraftInvoicesExTax` number, float, nullable: Total invoiced on draft invoices ex tax (job currency)
  - `jobCurrencyTotalAwaitingPaymentInvoicesExTax` number, float, nullable: Total invoiced on invoices awaiting payment ex tax (job currency)
  - `jobCurrencyTotalPaidInvoicesExTax` number, float, nullable: Total invoiced on paid invoices ex tax (job currency)
  - `jobCurrencyTotalIssuedInvoicesExTax` number, float, nullable: Total invoiced on issued invoices - awaiting payment plus paid - ex tax (job currency)
  - `orderId` number, float, nullable: Order in which the job item appears
  - `estimatedStartDate` string, date, nullable: Estimated start date
  - `estimatedEndDate` string, date, nullable: Estimated end date
  - `earliestStartDate` string, date, nullable: Earliest start date (calculated)
  - `latestEndDate` string, date, nullable: Latest end date (calculated)
  - `completedDate` string, date, nullable: Completion date
  - `incompleteJobItemSubItems` integer, nullable: Number of incomplete sub-items
  - `completeJobItemSubItems` integer, nullable: Number of complete sub-items

## Response `200`

Job item updated.

- JobItem: A job item within a job
  - `id` integer: Job item ID
  - `jobId` integer: Parent job ID
  - `jobPhaseId` integer, nullable: Job phase ID
  - `jobItemStatus` JobItemStatus: Status of a Job item.
    - `id` 1 | 2 | 3 | 4: Job Item Status ID (1=Planning, 4=Scheduled, 2=Complete, 3=Deleted)
    - `name` string
  - `name` string: Job item name
  - `description` string, nullable: Job item description
  - `sellRate` number, float, nullable: Explicit sell rate in job currency (if provided)
  - `costingMethod` CostingMethod
    - `id` 1 | 2 | 3 | 4: Consting Method ID (1=Item, 2=People, 3=Fixed Price Calculated Sell, 4=Fixed Price User Sell)
    - `name` string
  - `isBillable` boolean: Is this job item billable
  - `totalScheduledUsers` integer, nullable: Total scheduled users for the item
  - `totalJobItemRoles` integer, nullable: Total job item roles
  - `timeAllocationMethod` TimeAllocationMethod: How the time of an item is allocated, whether as a bucket that is shared amongst all users or individually assigned to each user.
    - `id` 1 | 2: Time Allocation Method ID (1=Item, 2=People)
    - `name` string
  - `totalPlannedMinutes` integer, nullable: Total planned minutes for the item
  - `totalIncompleteMinutes` integer, nullable: Total incomplete minutes for the item
  - `totalLoggedMinutes` integer, nullable: Total logged minutes for the item
  - `jobCurrencySellRate` number, float, nullable: Sell rate in job currency (per hour)
  - `jobCurrencyTotalIncompleteTimeExTax` number, float, nullable: Total incomplete time ex tax (job currency)
  - `jobCurrencyTotalPlannedTimeExTax` number, float, nullable: Total planned time ex tax (job currency)
  - `jobCurrencyTotalLoggedTimeExTax` number, float, nullable: Total logged time ex tax (job currency)
  - `jobCurrencyTotalLoggedTimeCostExTax` number, float, nullable: Total logged time cost ex tax (job currency)
  - `jobCurrencyTotalAmountInvoicedExTax` number, float, nullable: Total amount invoiced ex tax for this job item (job currency)
  - `jobCurrencyTotalDraftInvoicesExTax` number, float, nullable: Total invoiced on draft invoices ex tax (job currency)
  - `jobCurrencyTotalAwaitingPaymentInvoicesExTax` number, float, nullable: Total invoiced on invoices awaiting payment ex tax (job currency)
  - `jobCurrencyTotalPaidInvoicesExTax` number, float, nullable: Total invoiced on paid invoices ex tax (job currency)
  - `jobCurrencyTotalIssuedInvoicesExTax` number, float, nullable: Total invoiced on issued invoices - awaiting payment plus paid - ex tax (job currency)
  - `orderId` number, float, nullable: Order in which the job item appears
  - `estimatedStartDate` string, date, nullable: Estimated start date
  - `estimatedEndDate` string, date, nullable: Estimated end date
  - `earliestStartDate` string, date, nullable: Earliest start date (calculated)
  - `latestEndDate` string, date, nullable: Latest end date (calculated)
  - `completedDate` string, date, nullable: Completion date
  - `incompleteJobItemSubItems` integer, nullable: Number of incomplete sub-items
  - `completeJobItemSubItems` integer, nullable: Number of complete sub-items

---

[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)