info:
  name: Start Scanner
  type: http
  seq: 2
http:
  method: POST
  url: '{{base_url}}/api/scanner/start'
  auth: inherit

docs: |-
  ## Start Scanner
    
    Starts the media scanner service for indexing library content.
    
    **Method:** POST
    
    **Endpoint:** /api/scanner/start
    
    **Authentication:** Required (Bearer token)
    
    **Response:**
    - JSON object containing scanner status
      - `status` (string): Scanner state ("started", "running")
      - `message` (string): Status message
      - `started_at` (string): Timestamp when scanner started
    
    **Status Codes:**
    - 200: Scanner started successfully
    - 401: Unauthorized
    - 403: Forbidden (insufficient permissions)
    - 409: Scanner already running
    - 500: Internal server error