# Start Scanner Start the automated background scanner for a library. Supports ebook, manga, and comic libraries. **Endpoint**: `POST /api/scanner/start` **Auth**: Required (Admin only) **Content-Type**: `application/json` ## Request Body | Field | Type | Required | Description | |--------|------|-----------|-------------| | library_id | string (UUID) | Yes | Library UUID to scan (supports ebooks, manga, and comics) | | interval_seconds | integer | No | Scan interval in seconds (default: 3600, min: 300) | ## Supported Library Types - **Ebooks:** Processes .epub, .pdf, .mobi, and other ebook formats - **Comics:** Processes comic archives (.cbz, .cbr, .cb7, .cbt) with metadata extraction - **Manga:** Processes manga archives and image files (.cbz, .cbr, .png, .jpg, etc.) ### Example Request ```json { "library_id": "550e8400-e29b-41d4-a716-446655440000", "interval_seconds": 3600 } ``` ## Response (200 OK) ```json { "message": "Scanner started successfully", "library_id": "uuid", "interval_seconds": 3600, "status": "running" } ``` ## Error Responses | Code | Description | |------|-------------| | 400 | Invalid request data or interval too low | | 401 | Invalid or expired token | | 403 | User does not have admin privileges | | 404 | Library not found | | 409 | Scanner already running for this library |