Files

Confirm an upload request

Confirms an upload request. The person’s explicit approval: the staged files become their files (origin request, kept 7 days) in one atomic step, and from then a tool may name them. Idempotent: confirming a confirmed request returns the same files and writes nothing. 409 uploads_in_progress while a file is still uploading, no_files_staged when nothing was added, upload_request_closed once it has expired. Audited as file.upload_confirmed (count and names) and one file.uploaded per file.

post/file/upload-request/{id}/confirm

Request

  • Base URL: https://api.elaichi.ai
  • URL: https://api.elaichi.ai/file/upload-request/{id}/confirm
  • Auth: HTTP bearer

Path parameters

idstring required

Request id (fupr_…).

Headers

X-Organization-Idstring

Target organization (org_…). Required for cookie/session auth on org-scoped routes; optional for API tokens, which carry their organization, and rejected when it names a different one.

Request body

file_idsstring[] required

EXACTLY the staged files the person was shown. Any difference from what the server holds is 409 upload_changed and nothing is committed.

Response

OK

request_idstring

Request id (fupr_…).

status'open' | 'confirmed' | 'expired'

open: waiting for the person (files may be added, removed, confirmed). confirmed: they approved; the staged files are now theirs. expired: the deadline passed unconfirmed with nothing still uploading. A request whose upload STARTED before the deadline stays open until that upload finishes, and each finished file keeps it open for at least five more minutes, so someone mid-upload is never told it expired.

purposestring

What the files are for, as the asker said it.

requesterstring

Who is asking: the connected app’s name, or “Elaichi assistant”.

created_atstring date-time
add_files_untilstring date-time

Ten minutes after creation, fixed. No new file can be reserved after it; the person can still send the files they added.

expires_atstring date-time

The last moment the person can confirm (Send). Starts at add_files_until; it moves out when an upload finishes or an upload that was running ends without landing, never past 35 minutes after creation.

upload_page_urlstring

The Elaichi app page where the person confirms. Carries no secret: only the signed-in person who made the request can use it.

Changes

No recorded changes to this operation across all 1 revision of this API.