TOtoma

Finish a file upload

Verify and save the completed upload as one file for already authorized task participants. Retry completion if storage or upload cleanup fails. This does not submit work, complete the task, change access, or move money. Empty files are supported. Unfinished poster uploads remain hidden from workers; ready contents are immutable. The first successful completion queues an update for the other currently authorized participant; retries do not repeat it. Programs, installers, disk images, shortcuts, and macro-enabled Office files are refused by name. Windows, macOS, and Linux programs, Office macros, password-protected zip files, zip files that contain programs, and PDFs with visible script or launch actions are also refused by content; completing such an upload removes it.

post/api/tasks/{id}/files/{fileId}/complete

Request

  • Base URL
    https://www.toma.com
  • URL
    https://www.toma.com/api/tasks/{id}/files/{fileId}/complete
  • Auth
    • HTTP bearer
    • or API key in cookie better-auth.session_token

Path parameters

idstring required
fileIdstring required

Response

File operation result.

idstring required
folder'poster' | 'worker' required
publicboolean required

A poster file anyone can download from the open task's page (publicFiles on the task).

pathstring required
cautionstring nullable required

A warning to show the user before they download or open this kind of file (archives, scripts, older Office files, web pages); null when there is none.

hireIdstring nullable required
sizeinteger required
receivedinteger required
status'uploading' | 'ready' | 'deleting' required
createdAtstring date-time required
canWriteboolean required

Changes

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