# Content Upload Sessions

Content upload session management operations. Handle reliable file uploads through chunked upload sessions with progress tracking.

## Create a new content upload session

 - [POST /content-upload-sessions](https://docs.syncdocs.ai/api/workspace-openapi/content-upload-sessions/createuploadsession.md): 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.

## Upload file content

 - [POST /content-upload-sessions/{sessionId}/chunks](https://docs.syncdocs.ai/api/workspace-openapi/content-upload-sessions/uploadchunk.md): Uploads file content for an existing upload session.
Upload Process: - Upload content reliably with automatic error handling - System tracks progress automatically - Optional content integrity validation via checksum - Processes file when upload is complete - Creates content record upon completion
Upload Flow: 1. Upload content using multipart/form-data 2. System processes content reliably on server 3. When upload is complete, assembles into complete file 4. Stores complete file in secure storage 5. Creates content record in database 6. Cleans up temporary files
Error Handling: - Invalid content is rejected with detailed error messages - Failed processing triggers automatic cleanup - Session expiration prevents orphaned files

## Get upload session status

 - [GET /content-upload-sessions/{sessionId}](https://docs.syncdocs.ai/api/workspace-openapi/content-upload-sessions/getuploadsession.md): Retrieves the current status and progress of an upload session.
Session Statuses: - pending: Session created, awaiting content - uploading: Receiving content - assembling: Upload complete, processing file - completed: Upload successful, content created - failed: Upload failed, session invalid - expired: Session expired, cleanup scheduled
Progress Tracking: Use this endpoint to monitor upload progress by checking: - uploadedChunks vs totalChunks for progress percentage - status for current phase - contentId when upload completes