# Create a new content upload session

Initializes a new upload session for reliable file uploads.
Features: - Supports files up to 10GB - Optimized for large file transfers - Session expiration and cleanup - Progress tracking
Process: 1. Create upload session with file metadata 2. Upload file content using the session ID 3. System automatically processes the upload when complete 4. Returns content ID when finished
Upload Optimization: The system automatically optimizes the upload process for reliable transfer of large files with automatic retry and error handling.

Endpoint: POST /content-upload-sessions
Version: 1.0.0
Security: bearerAuth

## Request fields (application/json):

  - `fileName` (string, required)
    Name of the file
    Example: "large-document.pdf"

  - `fileSize` (integer, required)
    Size of the file in bytes
    Example: 104857600

  - `fileFormat` (string, required)
    MIME type of the file
    Example: "application/pdf"

  - `dataspaceId` (string, required)
    Target dataspace ID
    Example: "sds-abc12345"

## Response 201 fields (application/json):

  - `id` (string, required)
    Unique upload session ID
    Example: "123e4567-e89b-12d3-a456-426614174000"

  - `fileName` (string, required)
    Name of the file being uploaded
    Example: "large-document.pdf"

  - `fileSize` (number, required)
    Size of the file in bytes
    Example: 104857600

  - `fileFormat` (string, required)
    MIME type of the file
    Example: "application/pdf"

  - `chunkSize` (number, required)
    Size of each chunk in bytes
    Example: 1048576

  - `totalChunks` (number, required)
    Total number of chunks for this file
    Example: 100

  - `uploadedChunks` (number, required)
    Number of chunks uploaded so far
    Example: 45

  - `status` (string, required)
    Current status of the upload session
    Enum: "pending", "uploading", "assembling", "completed", "failed", "expired"

  - `contentId` (string)
    Content ID when upload is completed
    Example: "987e6543-e21b-43d2-b654-321098765432"

  - `expiresAt` (string, required)
    When this upload session expires
    Example: "2024-01-16T10:30:00Z"

  - `createdAt` (string, required)
    When this upload session was created
    Example: "2024-01-15T10:30:00Z"

  - `updatedAt` (string, required)
    When this upload session was last updated
    Example: "2024-01-15T11:15:00Z"


## Response 400 fields

## Response 401 fields

## Response 413 fields