---
title: "Changes a contract job's pay/bill rates or adds lines (BF-7522)."
method: PATCH
path: "/v{version}/ContractJobs/{jobId}/payBillItems"
tags: ["ContractJobs"]
---

# Changes a contract job's pay/bill rates or adds lines (BF-7522).

`PATCH /v{version}/ContractJobs/{jobId}/payBillItems`

Body: an array of { payBillItemId, costRate, billRate }. An item the job has gets the sent rates (a rate left
out stays; all rows of the item change together); a new item is added with the company's flags and default
or derived rates. Lines not listed are untouched; lines cannot be removed here. A line whose rate the company
derives from another (for example overtime from regular) follows its parent unless the request sets it.
Rates are 0 or more with at most 4 decimals. New rates apply to timecards generated after the change;
existing timecards keep their rates and invoiced amounts never change.

## Path parameters

- `jobId` integer, required
- `version` string, required

## Request body

- ContractsContractsRatesContractJobRateEntry[]
  - `payBillItemId` integer, nullable
  - `costRate` number, double, nullable
  - `billRate` number, double, nullable

## Response `200`

Success

- ContractsContractsRatesContractJobPayBillItemsResponse
  - `isValid` boolean
  - `errors` string[], nullable
  - `warnings` string[], nullable
  - `info` string[], nullable
  - `message` string, nullable
  - `data` ContractsContractsRatesContractJobPayBillItemView[], nullable
    - `payBillItemId` integer
    - `name` string, nullable
    - `costRate` number, double
    - `billRate` number, double
    - `includeInSales` boolean
    - `includeInCost` boolean
    - `isBurdened` boolean
    - `mapToPayroll` boolean
    - `rows` integer
    - `ratesDiffer` boolean

## Changes

- **2026-09-25** `5063eab95b17` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/bilflo/apis/bilflo-api/changes/v:version/ContractJobs/:jobId/payBillItems/patch.md)

---

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