Files

Read an upload request

Returns one upload request. It reports the request’s status, limits, deadline and files, to the person who made it. 404 for anyone else and for an id that does not exist, the same answer, so the page can say “this isn’t for this account” without confirming that a request exists.

get/file/upload-request/{id}

Request

  • Base URL: https://api.elaichi.ai
  • URL: https://api.elaichi.ai/file/upload-request/{id}
  • 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.

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.