Updates a lead's details. Send only the fields you want to change inside a lead object. The
writable fields are contact_id, title, lead_type, estimated_value, expected_close_on,
assigned_sales_rep_id, lead_source_id, property_address, property_city,
property_state, property_zip, claim_number and insurance_company.

To change which of the contact's addresses are on the deal, send the full list as address_ids
(addresses left out are unlinked) with an optional primary_address_id. To change the outcome
or stage, use the close, reopen and move-to-stage endpoints instead.

The token's user must be able to see the lead. A validation failure returns 422 with an
errors list.