meta {
  name: Scan Ebooks
  type: http
  seq: 1
}

post {
  url: {{base_url}}/api/scanner/scan
  body: json
  auth: inherit
}

settings {
  encodeUrl: true
  timeout: 0
}

docs {
  ## Scan Ebooks
  
  Scans configured ebook folders for ebooks and adds them to the database. **Admin only operation.**
  
  **Method:** POST
  
  **Endpoint:** /api/scanner/scan
  
  **Authentication:** Required (Admin role required)
  
  **Request Body:**
  - `folder_paths` (array of strings, optional): Array of folder paths to scan. If not provided, uses configured folders from Add Ebook Folder.
  
  **Response:**
  - `message` (string): Success message
  
  **Status Codes:**
  - 200: Success
  - 400: Bad Request
  - 401: Unauthorized
  - 403: Forbidden (non-admin users)
  
  **Usage:**
  - Without body: Scans all folders added via "Add Ebook Folder"
  - With folder_paths: Scans the specified paths directly (useful for testing)
  
  **Note:** All discovered ebooks will be associated with the admin user who initiated the scan.
}