Update a task

Changes only the fields you send. Everything else stays as it is.

Any status. A completed task can be edited or reopened. Moving a
loan task into Completed adds a note "

Clearing a field. Send null to clear reminderAt, priority or
details, or to detach the task from its loan (loanId: null). The
other fields cannot be cleared: null for subject, dueAt or
status is accepted only when the task already has none, which a task
made in LendingWise can lack. A credential limited to some branches
cannot detach a task from its loan (422).

Assignees. Send assignees to replace the whole list; leave it out
to keep it. At least one id is required, unless you are sending back an
empty list the read gave you (a task assigned only to a borrower, say).
Only ids you add are checked.

Moving the reminder. A new reminderAt means the reminder will be
sent again, even if the old one already went out.

Sending back what you read. You can send a task exactly as
GET /api/v4/tasks/{id} returned it: nothing changes, and nothing in it
is checked again, so an assignee who has since left your company does
not make the request fail. Any field equal to what the read shows is
treated as unchanged. The read-only fields (id, createdDate,
createdBy, reminderSent, isAutomationTask) are accepted when
unchanged and refused when not.

No email is sent on an update, even if you turn sendEmailNotification on.

404 and 409 mean what they mean on GET /api/v4/tasks/{id}; 409
also answers a move onto an archived loan.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Path Params
integer
required
≥ 1

The task's id.

Body Params

Every field is optional. Only what you send is changed.

string | null

null only when sending back a task that has no subject.

date-time | null

null only when sending back a task that has no due date.

date-time | null

null removes the reminder.

enum

null only when sending back a task that has no status.


A task's status, exactly as LendingWise stores and shows it.

enum
string | null
integer | null
≥ 1

null makes it a general task.

boolean
boolean

Stored only. No email is sent on an update.

assignees
object

Who the task is assigned to, by kind. At least one id in total. A broker id sent as a loan officer, or the reverse, is refused.

Responses

Language
Credentials
Bearer
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json