info:
  name: Create Library
  type: http
  seq: 1
http:
  method: POST
  url: '{{base_url}}/api/libraries'
  auth: inherit
  body:
    type: json
    jsonBody: "{\n    \"name\": \"My Ebook Library\",\n    \"description\": \"A collection\
      \ of technical books and novels\",\n    \"type\": \"ebooks\""
  headers:
  - key: Content-Type
    value: application/json

docs: |-
  ## Create Library
    
    Creates a new library for organizing media items.
    
    **Method:** POST
    
    **Endpoint:** /api/libraries
    
    **Authentication:** Required (Bearer token)
    
    **Request Body:**
    - `name` (string, required): Library name
    - `description` (string, optional): Library description
    - `type` (string, required): Library type
      - `"ebooks"`: Electronic books
      - `"audiobooks"`: Audio books
      - `"videos"`: Video content
      - `"other"`: Other media types
    
    **Response:** Library object
    - `id` (string): Library UUID
    - `name` (string): Library name
    - `description` (string, optional): Library description
    - `type` (string): Library type
    - `is_visible` (boolean): Library visibility status
    - `created_at` (string): Creation timestamp
    - `updated_at` (string): Last update timestamp
    
    **Status Codes:**
    - 201: Library created successfully
    - 400: Invalid request data
    - 401: Unauthorized
    - 403: Forbidden (insufficient permissions)
    - 409: Library name already exists
    - 500: Internal server error