meta {
  name: Add Library Folder
  type: http
  seq: 1
}

post {
  url: {{base_url}}/api/libraries/{{library_id}}/folders
  body: json
  auth: inherit
}

headers {
  Content-Type: application/json
}

body:json {
  {
    "folder_path": {{library_folder}}
  }
}

vars:pre-request {
  libraryId: "8821b703-h29b-71d4-d716-446655440003"
}

settings {
  encodeUrl: true
  timeout: 0
}

docs {
  ## Add Library Folder
  
  Adds a new folder path to a library for media scanning and indexing.
  
  **Method:** POST
  
  **Endpoint:** /api/libraries/{id}/folders
  
  **Authentication:** Required (Bearer token, admin permissions)
  
  **Path Parameters:**
  - `id` (string, required): Library UUID
  
  **Request Body:**
  - `folder_path` (string, required): Absolute path to the folder containing media files
  
  **Response:** Folder object
  - `id` (string): Folder UUID
  - `library_id` (string): Library UUID
  - `folder_path` (string): Absolute path to folder
  - `is_active` (boolean): Whether folder is active for scanning
  - `created_at` (string): Creation timestamp
  - `updated_at` (string): Last update timestamp
  
  **Status Codes:**
  - 201: Folder added successfully
  - 400: Invalid folder path or request data
  - 401: Unauthorized
  - 403: Forbidden (admin access required)
  - 404: Library not found
  - 409: Folder already exists for this library
  - 500: Internal server error
}