meta {
  name: Clear Kobo Shelf
  type: http
  seq: 1
}

delete {
  url: {{baseURL}}/api/devices/{{deviceID}}/shelves/clear?shelf={{shelfName}}
  body: none
  auth: inherit
}

headers {
  Authorization: Bearer {{userToken}}
}

settings {
  encodeUrl: true
  timeout: 0
}

docs {
  ## Clear Kobo Shelf

  Clear all books from a Kobo device shelf, or all shelves if no shelf name is specified.

  **Method:** DELETE

  **Endpoint:** /api/devices/{deviceID}//shelves/clear?shelf={shelfName}

  **Authentication:** Bearer token

  **Path Parameters:**
  - `deviceID` (string): Device UUID

  **Query Parameters:**
  - `shelf` (string, optional): Shelf name to clear. If omitted, clears all shelves.

  **Response:**
  - `message` (string): Success message
  - `cleared_count` (number): Number of books removed from shelf

  **Status Codes:**
  - 200: Success - shelf cleared
  - 401: Unauthorized
  - 404: Device not found
  - 500: Internal server error

  **Note:** Removes all books from the specified shelf. If no shelf name is provided, clears all shelves for the device. This operation cannot be undone.
}