Initialize Batch Upload [Auth Required]
Initialize batch upload session.
Creates a database-backed session for batch uploading images to an existing folder. Sessions expire after 24 hours and support up to 1000 files.
Security:
- Requires authentication (Bearer token)
- Rate limited to 10 requests/minute
- Validates folder exists and belongs to user
Request: - folder_id: UUID of existing folder (MUST exist before batch upload) - file_count: Number of images to upload (max 1000)
Response: - session_id: UUID for subsequent uploads (valid for 24 hours)
Workflow:
- Validate user has org roles
- Validate folder exists and belongs to user
- Validate file_count <= 1000
- Create database session with 24-hour TTL
- Return session_id
Constraints:
- Maximum 1000 files per session
- Session expires after 24 hours
- Folder must exist before session creation
- Folder must belong to authenticated user
post/new-batch-import
Request
- The document declares no server URL.
- Auth: none declared
Request body
Response
Successful Response
Changes
No recorded changes to this operation across all 4 revisions of this API.