Files

Start an upload session

Start a multipart upload of a file of up to 5 GiB, admitted like a one-request upload. Upload every part to upload_url, then complete the upload; the bytes must match size_bytes and sha256.

post/v1/files/uploads

Request

  • Base URL
    https://api.dexto.ai
  • URL
    https://api.dexto.ai/v1/files/uploads
  • Auth
    HTTP bearer

Request body

content_typestring
expires_atstring date-time

Delete the file at this time. Files are kept until deleted when omitted.

metadataobject

Up to 32 string entries and 4096 bytes; keys are letters, digits, '_', '.' or '-'.

overwriteboolean

Replace a file that already has this path.

pathstring required

The file's path in the project, such as reports/q3.pdf.

sha256string required

Lowercase hex SHA-256 of the bytes.

size_bytesinteger required

Response

Created.

expires_atstring date-time required
file_idstring uuid nullable required
idstring uuid required
object'file.upload' required
overwriteboolean required
part_countinteger required
part_size_bytesinteger required
pathstring required
sha256string required
size_bytesinteger required
status'pending' | 'completed' required
upload_urlstring uri nullable required

PUT each part to <upload_url>/<part_number> without an API key; null once completed.

Changes

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