Skip to navigation
Files

Confirm an upload

View as Markdown

Finish an upload after the PUT to its upload URL has succeeded.

Records the stored file’s size and checksum, makes the file visible in listings, and notifies triggers and parsers. Files over 500 MB and native executables are discarded with a 400, as the one-request upload rejects them. Confirming new contents for an API-uploaded file replaces its contents and notifies triggers and parsers again, unless the contents are unchanged. Rejected contents leave the file as it was. Confirming a file that is already confirmed returns its record again without notifying anyone twice. The Upload files guide shows the full sequence.

Requires an API key with the write scope.

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Path parameters

file_idstringRequiredformat: "uuid"

Response

OK
file_idstring
The ID of the uploaded file.
file_namestring
The original file name.
size_kilobytesinteger or null
File size in kilobytes.

Errors

400
Bad Request Error
401
Unauthorized Error
403
Forbidden Error
404
Not Found Error
422
Unprocessable Entity Error
500
Internal Server Error