Upload Workflow

Uploads are a two-stage flow used by SoluDesks API families such as LearnHub. First create an upload session through SoluDesks. Then upload the bytes directly to the returned storage URL and complete the session.

1. Initiate Upload

curl "https://staging.api.soludesks.com/v1/external/learnhub/uploads" \
  -X POST \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Idempotency-Key: 3b3a7f97-9b41-4bc9-8c55-8f00a5d2147a" \
  -H "Content-Type: application/json" \
  -d '{
    "upload_type": "VIDEO",
    "file_name": "intro.mp4",
    "file_size": 52428800,
    "content_type": "video/mp4"
  }'

The response includes either presigned_url for single-part uploads or presigned_urls plus multipart_upload_id for multipart uploads.

2. Upload To Storage

For a single-part upload, send the file with the returned required_headers.

curl "$PRESIGNED_URL" \
  -X PUT \
  -H "Content-Type: video/mp4" \
  --upload-file ./intro.mp4

For multipart uploads, upload each part to its matching presigned URL. You can request more part URLs with the sign-parts endpoint.

3. Complete Upload

curl "https://staging.api.soludesks.com/v1/external/learnhub/uploads/UPLOAD_ID/complete" \
  -X POST \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'

For multipart uploads, include the uploaded part numbers and ETags.

{
  "parts": [
    {
      "part_number": 1,
      "etag": "\"etag-from-storage\""
    }
  ]
}

4. Use The Upload ID

After completion, use the upload session ID in fields such as cover_image_upload_session_id, preview_video_upload_session_id, video_upload_session_id, document_upload_session_id, image_upload_session_id, content_media[].upload_session_id, or resource_upload_session_ids.

Start here

Core concepts

Workflows

1. Initiate Upload

2. Upload To Storage

3. Complete Upload

4. Use The Upload ID

​1. Initiate Upload

​2. Upload To Storage

​3. Complete Upload

​4. Use The Upload ID

1. Initiate Upload

2. Upload To Storage

3. Complete Upload

4. Use The Upload ID