info:
  name: Create Device Mapping
  type: http
  seq: 9
http:
  method: POST
  url: '{{base_url}}/api/devices/{{device_id}}/collections'
  auth: inherit
  body:
    type: json
    jsonBody: "{\n    \"collection_id\": \"{{collection_id}}"

docs: |-
  ## Create Device Mapping
  
    Maps a collection to a device shelf for synchronization.
    
    **Method:** POST
    
    **Endpoint:** /api/devices/{device_id}/collections
    
    **Authentication:** Required (Bearer token)
    
    **Path Parameters:**
    - `device_id` (string): Device ID
    
    **Request Body:**
    - `collection_id` (string, required): Collection ID to map
    - `device_shelf_name` (string, optional): Custom shelf name on device
    - `sync_direction` (string, optional): sync direction (book_to_device, device_to_book, bidirectional)
    
    **Response:**
    - Mapping object with generated ID
    
    **Status Codes:**
    - 201: Created
    - 400: Invalid request
    - 401: Unauthorized
    - 404: Device or collection not found