Deprecated — use PATCH /api/v4/loans/{id}/employees instead, which
takes the same employeeIds list, and also lets an employee who has
since been deactivated stay on a file they are already on. This PUT
keeps working until its retirement date, 2026-12-09. Its
responses carry a Deprecation: @1791504000 header (RFC 9745: the
date it was deprecated, 2026-10-09, in Unix seconds), and a
Sunset: Wed, 09 Dec 2026 00:00:00 GMT header (RFC 8594: the
retirement date). A request refused
before it reaches this endpoint — an unreadable body (400), a missing
or bad token (401), a body not labelled as JSON (415) or too many
requests (429) — does not carry them.
Sets which of your back-office employees are working on this loan file.
What you send becomes the complete list: anyone you leave out is taken
off, and anyone new is added. Send an empty list to take everyone off.
Each id may appear only once; a repeated id is refused with 422.
If any single id is not an active back-office employee on your account,
the whole request is refused with 422 and nothing changes at all.
You'll get a 404 if the loan file is not on your account, or is filed under a branch you are not assigned to.
Each change is also written onto the loan file, so your staff can see
it where they normally look:
- A note for every employee added or taken off — "File assigned to
Jane Doe (Processor)", "File removed from …" — which shows up in the
back office under Notes History. Whether that note is private
follows your company's setting for system notes. - The loan file's last-updated time moves when the request adds
someone. Taking someone off does not move it, which matches what the
back office does. - The assignment history records that the change came in through the
API. - Every employee added is emailed, the same message the back office
sends when someone is assigned. Employees taken off are not emailed.
The mail goes out through the same background process that sends all
LendingWise mail, so it leaves shortly after your request rather than
during it.
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||

