LIlilt
Uploads

Get S3 Upload Parameters

Changed on

Get S3 upload parameters via query string. This endpoint provides the necessary information to complete the file upload process using GET parameters.

Example CURL command:

  curl -X GET "https://lilt.com/v2/upload/s3/params?key=API_KEY&filename=example.json&type=application/json&metadata.size=1024&metadata.labels=important,review-needed"
get/v2/upload/s3/params

Request

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

Query parameters

filenamestring required
Example:document.xliff

A file name including file extension.

typestring required
Example:video/mp4

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

metadata.sizeinteger
Example:1024

The size of the file to upload in bytes.

metadata.categorystring
Example:documents

File category metadata.

metadata.uuidstring
Example:123e4567-e89b-12d3-a456-426614174000

File UUID metadata.

metadata.labelsstring
Example:important,review-needed

Comma-separated list of label names to be added to the file after upload completes.

Response

Upload initialization information.

urlstring

Pre-signed URL for file upload

keystring

Upload key identifier

methodstring

HTTP method to use for upload

Example response

{
  "url": "https://storage.googleapis.com/bucket/uploads/user123/file456.json?...",
  "key": "uploads/user123/file456.json",
  "method": "PUT"
}

Changes

  • 99b66cc7808dRevision changes
    • breaking

      added the new required query request parameter filename

    • breaking

      added the new required query request parameter type

    • info

      api operation id getS3UploadParams was added

    • info

      added the new optional query request parameter metadata.category

    • info

      added the new optional query request parameter metadata.labels

    • info

      added the new optional query request parameter metadata.size

    • info

      added the new optional query request parameter metadata.uuid

    • info

      added the success response with the status