Initiate a multipart upload to S3

POST/api/upload/initiate

Authorization

AuthorizationBearer token (JWT) · headerrequired

Header parameters

x-organization-idstring

Target organization id. Defaults to the caller's personal organization when omitted.

Request body

requiredapplication/json

fileNamestringrequired

contentTypestringrequired

partCountnumberrequired

collectionIdstringrequired

Responses

201Upload initiated

any

400Bad Request

any

401Unauthorized

any

500Internal Server Error

any

Try it

Server

Base URLCustom base URLOverrides the selected server when set.

Authorization

Bearer token (JWT)Remember on this deviceInclude my values in samples

Parameters

x-organization-idheaderTarget organization id. Defaults to the caller's personal organization when omitted.

Bodyapplication/json

fileNamestring*contentTypestring*partCountnumber*collectionIdstring*

Request

curl -X POST "http://localhost:8000/api/upload/initiate" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "fileName": "example.png",
  "contentType": "image/png",
  "partCount": 5,
  "collectionId": "CL01"
}'

const response = await fetch("http://localhost:8000/api/upload/initiate", {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_TOKEN",
    "Content-Type": "application/json"
  },
  body: "{\n  \"fileName\": \"example.png\",\n  \"contentType\": \"image/png\",\n  \"partCount\": 5,\n  \"collectionId\": \"CL01\"\n}"
});

Response

{
  "message": "Upload Initiated",
  "data": {
    "uploadId": "vY7.L8mP0zRQW...",
    "key": "collection/CLq4Wm7x1P/uuid-filename.png",
    "presignedUrls": [
      "https://s3.amazonaws.com/tala-store/key?partNumber=1&uploadId=...",
      "https://s3.amazonaws.com/tala-store/key?partNumber=2&uploadId=..."
    ]
  }
}

{
  "message": "Invalid file metadata",
  "error": "Bad Request",
  "statusCode": 400
}

{
  "message": "You are not authorized to perform this action",
  "error": "Unauthorized",
  "statusCode": 401
}

{
  "message": "Something went wrong",
  "error": "Internal Server Error",
  "statusCode": 500
}