Uploads

Initiate Multipart Upload

Changed on

Initiate a multipart upload for large files. This endpoint provides the necessary information to start a multipart upload process.

Supports both single file and bulk upload requests. For bulk uploads, pass an array of upload objects (maximum 100 items). The response format matches the request format - a single object for single file requests, or an array for bulk requests.

Example CURL command (single file):

  curl -X POST https://lilt.com/v2/upload/s3/multipart?key=API_KEY \
  --header "Content-Type: application/json" \
  --data-raw '{
    "filename": "large-file.zip",
    "type": "application/zip",
    "metadata": {
      "size": 104857600
    }
  }'

Example CURL command (bulk upload):

  curl -X POST https://lilt.com/v2/upload/s3/multipart?key=API_KEY \
  --header "Content-Type: application/json" \
  --data-raw '[
    {
      "filename": "large-file1.zip",
      "type": "application/zip",
      "metadata": { "size": 104857600 }
    },
    {
      "filename": "large-file2.zip",
      "type": "application/zip",
      "metadata": { "size": 209715200 }
    }
  ]'
post/v2/upload/s3/multipart

Request

  • Base URL
    https://api.lilt.com
  • URL
    https://api.lilt.com/v2/upload/s3/multipart
  • Auth
    HTTP basic

Request body

filenamestring required

A file name including file extension.

typestring required

The content-type or mime-type of the file to upload.

Example request

{
  "filename": "large-file.zip",
  "type": "application/zip",
  "metadata": {
    "size": 104857600,
    "category": "documents",
    "uuid": "123e4567-e89b-12d3-a456-426614174000",
    "labels": [
      "important",
      "review-needed"
    ]
  }
}

Response

Multipart upload initialization information. Returns a single object for single file requests, or an array of objects for bulk requests.

uploadIdstring

Multipart upload ID for subsequent part uploads

keystring

Upload key identifier

Example response

{
  "uploadId": "abc123def456",
  "key": "uploads/user123/large-file.zip"
}

Changes

    • breaking

      added required request body

    • info

      api operation id initiateMultipartUpload was added

    • info

      added the success response with the status