CAcasemark
Vaults

Initiate multipart upload for vault file

Changed on

Initiate a multipart upload for large files (>5GB). Single PUT uploads are capped at 5GB; multipart default max is 16GB (configurable). Multipart uploads are supported in production. Returns an uploadId and object metadata. Use part URLs endpoint to upload parts and complete endpoint to finalize.

post/vault/{id}/multipart/init

Request

  • Base URL
    https://api.case.dev
  • URL
    https://api.case.dev/vault/{id}/multipart/init
  • Auth
    HTTP bearer

Path parameters

idstring required

Vault ID to upload the file to

Request body

filenamestring required

Name of the file to upload

contentTypestring required

MIME type of the file

sizeBytesinteger required

File size in bytes (required, default max 16GB). Configure via VAULT_MULTIPART_MAX_FILE_SIZE_BYTES.

partSizeBytesinteger

Multipart part size in bytes (min 5MB, max 5GB). Defaults to 64MB.

metadataobject

Additional metadata to associate with the file

file_originobject

Optional client-defined provenance metadata. Returned with the object and queryable through the object-list API.

auto_indexboolean

Whether to automatically process and index the file for search

is_ai_generatedboolean

Marks the file as AI-generated work product (e.g. uploaded by an agent) rather than a user-provided source document. Persisted on the object and returned by object listings so clients can distinguish provenance.

pathstring

Optional folder path, excluding the filename, for hierarchy preservation

Response

Multipart upload initiated

objectIdstring
uploadIdstring
s3Keystring
partSizeBytesinteger
partCountinteger
file_originobject nullable

Client-defined provenance metadata associated with the file

next_stepstring

Changes