Update a project

Updates a project. Every field is optional, and anything you leave out keeps its current value.

Sending null clears finish_date, billing_fee and billing_cycle. title, start_date, billing_type and board_group_id can be changed but not cleared.

Whenever you touch a billing field the resulting combination is checked, not just the values you sent — so moving a retainer to time means clearing the fee and cycle in the same request:

billing_type	billing_fee	billing_cycle
fixed_fee	required	must be empty
retainer	required	required
time	must be empty	must be empty
not_billable	must be empty	must be empty

billing_type, billing_fee and billing_cycle need permission to see billing; without it the whole request is rejected with 422 not_accessible and nothing is saved. Existing time entries keep the rate they were logged at — a billing change applies to new ones only.

finish_date has to be on or after start_date, whether you send both or only one of them — the other is taken from the project as it stands.

board_group_id moves the project to another stage of the project board it is already on — a stage belonging to a different board is rejected. Find one with GET /public-api/v1/board_groups?filter[resource_type]=Project. A project that is on no board yet can be filed onto any of them.

The client company and the currency are both fixed once a project exists, so company_id and currency are ignored here. Amounts already recorded against a project are never converted, so changing its currency would silently restate them — set it when you create the project.

A project the token cannot see returns 404, and one it can see but may not change returns 403.