Sets a timekeeper's rate in a Rate Table category from effective_from. rate_table_category must be a category on rate_table. If a rate already starts on that date it's replaced; otherwise a new rate is added, the rate before it now ends the day before, and the new rate runs until the next rate starts. A scheduled removal of the timekeeper from the table is kept. effective_from defaults to today and can't be in the past, and an existing rate's date can't be moved: set a rate on the new date instead. rate is required; null clears the timekeeper's rate from that date, so billing falls back to the next rate source. effective_until is worked out from the timeline and can't be set; it's ignored if sent. The timekeeper is a firm User, or an ad hoc Group when rate table groups are turned on for the account; name it with timekeeper[id] and timekeeper[type]. The timekeeper must already be on the Rate Table on effective_from; add them with the Rate Table Timekeepers endpoint first.

Send up to 200 rates at once as an array with the X-BULK: true header. The whole payload is checked first: if any item is invalid, nothing is saved and the 422 response lists each bad item by its position in data. Otherwise the response is 202 Accepted and the rates are saved in the background; items sent without effective_from all start on the date they were checked against. Poll the bulk action, whose id is in the X-Bulk-Action header, for the results, which hold one result per item, in request order. The table can change between the check and the save, so a completed bulk action can still contain failed items: check each item's status.