info:
  name: Scan Media Items (Background)
  type: http
  seq: 1
http:
  method: POST
  url: '{{base_url}}/api/scanner/scan'
  auth: inherit
  body:
    type: json
    jsonBody: "{\n    \"folder_paths\": [\"/path/to/media\"]"

docs: |-
  ## Scan Media Items (Background)
    
    Triggers an asynchronous media items scanning operation. The scan runs in the background and can be monitored using the job ID.
    
    **Method:** POST
    
    **Endpoint:** /api/scanner/scan
    
    **Authentication:** Required (Bearer token, Admin only)
    
    **Request Body:**
    - `folder_paths` (array of strings, required): List of folder paths to scan
       - Example: `["/path/to/media", "/another/path"]`
    
    **Response:** HTTP 202 (Accepted)
    ```json
    {
      "message": "scan job enqueued",
      "job_id": "550e8400-e29b-41d4-a716-446655440000",
      "status": "pending"