Uploads a file to attach to the candidate's profile.

Requires the candidatesWrite permission.

Recommended: Presigned upload handle Use file.createFileUploadHandle with fileUploadContext: "CandidateFiles" to get a presigned URL. Upload the file directly to that URL, then call this endpoint with the returned fileHandle. This avoids sending file bytes through the API, improving upload reliability and reducing latency for large files.

Deprecated: Multipart upload Send the file as multipart/form-data with the file in a file field. This mode is deprecated and may be removed in a future API version.