Complete a personal file upload

Verify and save your completed upload as one private file. Empty files are supported. Retry completion if storage or upload cleanup fails. Ready contents are immutable; delete and upload again to replace. 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/me/files/{fileId}/complete

Request

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

Path parameters

fileIdstring required

Response

File operation result.

idstring required
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.

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.