Put a file into one of the slots the checklist returned — the same thing
as dropping a file onto a row on the loan file's Docs tab. It shows
up for the lender exactly as a portal upload does, the slot moves to the
account's configured post-upload status, a note is written to the loan's
activity, and the people who would normally be told are told.
Address the slot with the id the checklist gave you. Do not look it up
by document name, and do not build it yourself.
Uploading adds to a slot; it never replaces. Four files in one slot
is a perfectly normal state.
⚠️ There is no delete and no replace. A file uploaded through this
API cannot be removed through this API. If you send the wrong file, it
stays there and someone has to remove it from inside the application.
Check before you send.
Notifications are on unless you turn them off. Pass notify=false
for a bulk backfill so you do not send hundreds of emails. Turning them
off only ever silences people — it can never notify someone whose own
settings say not to, and never adds a recipient.
Retries: send an Idempotency-Key. Nothing downstream removes a
duplicate, so if a request times out and you retry without a key you may
end up with the same file in the slot twice, permanently.
With a key, a retry of a request that succeeded returns the original
result instead of uploading again. A retry of a request that failed
where we could not tell whether the file was stored — a 502 saying
so — answers 409 rather than repeating it: re-read the loan's document
checklist, and use a new key if you decide to send the file again.
Reusing a key with a different file or a different note is a 409,
not a silent success.
The maximum file size is 64 MB. A larger file is refused with 422
and a message naming the limit; a request body too large for the server
to read at all is refused with 413. Accepted file types are decided by
the document store, not by this endpoint.
⚠️ Uploaded files are not scanned for malware. Nothing on the
platform scans uploaded content today. Scan on your side before sending
anything you did not produce.
The response is the same slot shape the checklist returns, already
updated, so you can refresh your view without calling again.
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||

