# Browse Library Folders Browse server directories for folder selection in library management. **Endpoint**: `GET /api/libraries/browse` **Auth**: Required (Admin only) ## Query Parameters | Parameter | Type | Required | Description | |-----------|------|-----------|-------------| | path | string | No | Directory path to browse (default: "/") | ## Request Headers | Header | Type | Required | Description | |--------|------|-----------|-------------| | Authorization | string | Yes | Bearer token (admin only) | ### Example Request ```http GET /api/libraries/browse?path=/home/user Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9... ``` ## Response (200 OK) ```json { "current_path": "/home/user", "parent_path": "/home", "directories": ["Documents", "Downloads", "Books", "Music"] } ``` ## Error Responses | Code | Description | |------|-------------| | 400 | Path traversal attempt or invalid path | | 401 | Invalid or expired token | | 403 | User is not an admin | | 400 | Path does not exist | | 400 | Path is not a directory | ## Security - **Path traversal protection**: Blocks requests containing ".." - **Admin only**: Regular users receive 403 Forbidden - **Directories only**: Returns only directory names, not file listings - **Server filesystem**: Browses server's filesystem, not client's