v19

latestOpenAPI 3.1.1raw.githubusercontent.com2026-08-017489931.2 KB

Complete a file upload

Finalizes an upload after the file bytes have been uploaded.

If an optional md5 hex digest is provided, the server validates the checksum before marking the file as completed.

Required scope: files:create

Rate limit category: Write

post/v1/files/{id}/complete

Path parameters

idstring required

Unique identifier of the file to complete.

Headers

Lightfield-Version'2026-03-01' required

Required API version header. Requests may error without it.

Request body

md5string

Optional MD5 hex digest of the uploaded file for checksum verification.

Response

OK

idstring required

Unique identifier for the file.

status'PENDING' | 'COMPLETED' | 'CANCELLED' | 'EXPIRED' required

Current upload status of the file.

filenamestring required

Original filename.

mimeTypestring required

MIME type of the file.

sizeBytesinteger required

File size in bytes.

createdAtstring required

When the file upload session was created.

completedAtstring nullable required

When the file upload was completed.

expiresAtstring nullable required

When the upload session expires. Null once completed, cancelled, or expired.