Updates a candidate

If valid, the candidate will be updated directly in Infinity.

NOTE: All fields will be replaced in the record even when they are not passed into the request. e.g If "Forename" is omitted it will be blank in Infinity

Comments, Summary and Insights must not exceed the max upload size configured in Infinity.

A Photo must not exceed the max upload size configured in Infinity.

The max upload size can be retrieved from the /Reference/MaxUploadSize method (In KB).

All id fields must match reference data from the /Reference methods.

EAA and RightToWork fields can only be changed if the system is not set up to auto-populate EAA/Right to Work information, and if the candidate's right to work is not controlled by TrustID

The ContractualLegalLawfulBasis field can only be set to None, ContractualLegal or left blank.

The ConsentLegitimateInterestLawfulBasis field can only be set to None, DigitalConsent, VerbalConsent, LegitimateInterest, NotRequired or left blank. When set, the LawfulBasisStatusId field must be set to a valid value for the type of consent which can be retrieved from the /Reference/LawfulBasisStatuses method.

The Financials.WorkerTypeId only supports worker types with a territory of 'United Kingdom'.

The Financials.BankAccountNumber must be 8 digits when set

The Financials.BankSortCode must be 6 digits when set

The Financials.IBANNumber must be in a valid format when set according to the following RegEx [A-Z]{2}[0-9]{2}[A-Z0-9]{1,30}

The Financials.SwiftCode must be in a valid format when set according to the following RegEx [A-Z]{6}[A-Z0-9]{2}[A-Z0-9]{0,3}

The Telecoms field can only contain one item set as IsPreferredTelecom

The Addresses field must have one item that is marked as SendByDefault if addresses are set. Each item must also have a unique address type.

Candidate StatusId must be set to a valid value. The /Reference/CandidateStatuses method will tell you if a status is a shortlist status or not. A shortlist status is one which has work-flow behind it.

A Candidate's status can only be changed if: Its current value is not a shortlist status, and the new value is not a shortlist status, or the current status is 'Placed By Us' or 'Placed By Us, But Looking' and the new value is also one of those, or the current status is 'Working For Us' or 'Working For Us, But Looking' and the new value is also one of those.

In other cases, if the status values are different, the request will be rejected.

If passed, the CustomFieldData must adhere to the field definitions retrieved from the /Reference/CustomFields method especially regarding item ids, in the case of combo boxes and multi-select lists, min/max values for dates and max length for text. Note that the Candidate update request will fail if the custom data is not valid.