Initiate Multipart Upload

POST 
/api/v1/upload/multipart/initiate

Starts a multipart upload session, creates a DB record, and returns presigned URLs for all parts.

Request

application/json

Body

required

fileName stringrequired

File name (no spaces allowed)

objectKey string

Optional full object key. If omitted, the server generates one (upload/{userId}/{uuid}/{fileName}) to keep the bucket layout consistent. If supplied, it is used as-is and the caller owns the outcome.

contentType string

Default value: application/octet-stream

MIME type of the file

fileSize numberrequired

Total file size in bytes

enableSbomScan boolean

Default value: true

Whether to trigger an SBOM scan after upload

Responses

201

application/json

Schema

Schema

uploadId stringrequired

S3 multipart upload ID

objectKey stringrequired

Full object key in the bucket

fileUploadId numberrequired

Database record ID for this file upload

partSize numberrequired

Part size in bytes

partCount numberrequired

Total number of parts

urls

object[]

required

Presigned URLs for all parts

Array [

partNumber numberrequired

Part number (1-based)

url stringrequired

Presigned URL for uploading this part

]

Example (from schema)

{
  "uploadId": "string",
  "objectKey": "string",
  "fileUploadId": 0,
  "partSize": 0,
  "partCount": 0,
  "urls": [
    {
      "partNumber": 0,
      "url": "string"
    }
  ]
}

Loading...