Jobs

Job Items

Create a job item

Creates a new job item for a job.

post/jobs/{job_id}/job_items

Request

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

Path parameters

job_idinteger required

Request body

idinteger

Job item ID

jobIdinteger

Parent job ID

jobPhaseIdinteger nullable

Job phase ID

namestring

Job item name

descriptionstring nullable

Job item description

sellRatenumber float nullable

Explicit sell rate in job currency (if provided)

isBillableboolean

Is this job item billable

totalScheduledUsersinteger nullable

Total scheduled users for the item

totalJobItemRolesinteger nullable

Total job item roles

totalPlannedMinutesinteger nullable

Total planned minutes for the item

totalIncompleteMinutesinteger nullable

Total incomplete minutes for the item

totalLoggedMinutesinteger nullable

Total logged minutes for the item

jobCurrencySellRatenumber float nullable

Sell rate in job currency (per hour)

jobCurrencyTotalIncompleteTimeExTaxnumber float nullable

Total incomplete time ex tax (job currency)

jobCurrencyTotalPlannedTimeExTaxnumber float nullable

Total planned time ex tax (job currency)

jobCurrencyTotalLoggedTimeExTaxnumber float nullable

Total logged time ex tax (job currency)

jobCurrencyTotalLoggedTimeCostExTaxnumber float nullable

Total logged time cost ex tax (job currency)

jobCurrencyTotalAmountInvoicedExTaxnumber float nullable

Total amount invoiced ex tax for this job item (job currency)

jobCurrencyTotalDraftInvoicesExTaxnumber float nullable

Total invoiced on draft invoices ex tax (job currency)

jobCurrencyTotalAwaitingPaymentInvoicesExTaxnumber float nullable

Total invoiced on invoices awaiting payment ex tax (job currency)

jobCurrencyTotalPaidInvoicesExTaxnumber float nullable

Total invoiced on paid invoices ex tax (job currency)

jobCurrencyTotalIssuedInvoicesExTaxnumber float nullable

Total invoiced on issued invoices - awaiting payment plus paid - ex tax (job currency)

orderIdnumber float nullable

Order in which the job item appears

estimatedStartDatestring date nullable

Estimated start date

estimatedEndDatestring date nullable

Estimated end date

earliestStartDatestring date nullable

Earliest start date (calculated)

latestEndDatestring date nullable

Latest end date (calculated)

completedDatestring date nullable

Completion date

incompleteJobItemSubItemsinteger nullable

Number of incomplete sub-items

completeJobItemSubItemsinteger nullable

Number of complete sub-items

Example request

{
  "id": 10001,
  "jobId": 601,
  "jobPhaseId": 3,
  "name": "UI Design",
  "description": "Wireframes and high-fidelity mockups",
  "sellRate": 120,
  "isBillable": true,
  "totalScheduledUsers": 2,
  "totalJobItemRoles": 1,
  "totalPlannedMinutes": 240,
  "totalIncompleteMinutes": 120,
  "totalLoggedMinutes": 180,
  "jobCurrencySellRate": 150,
  "jobCurrencyTotalIncompleteTimeExTax": 300,
  "jobCurrencyTotalPlannedTimeExTax": 900,
  "jobCurrencyTotalLoggedTimeExTax": 720,
  "jobCurrencyTotalLoggedTimeCostExTax": 480,
  "jobCurrencyTotalAmountInvoicedExTax": 500,
  "jobCurrencyTotalDraftInvoicesExTax": 120,
  "jobCurrencyTotalAwaitingPaymentInvoicesExTax": 180,
  "jobCurrencyTotalPaidInvoicesExTax": 200,
  "jobCurrencyTotalIssuedInvoicesExTax": 380,
  "orderId": 3,
  "estimatedStartDate": "2025-02-01",
  "estimatedEndDate": "2025-03-15",
  "earliestStartDate": "2025-02-02",
  "latestEndDate": "2025-03-20",
  "completedDate": "2025-03-18",
  "incompleteJobItemSubItems": 2,
  "completeJobItemSubItems": 5
}

Response

Job item created.