---
method: POST
path: /api/collections/:id/books/bulk-remove
auth: jwt
area: collections
---
<!-- source: internal/handlers/collections.go:601 CollectionHandler.BulkRemoveBooks -->

# Bulk Remove Books

Removes multiple books from a collection at once.

## Example request

```json example-request
{
  "book_ids": [
    "550e8400-e29b-41d4-a716-446655440000",
    "660e8400-e29b-41d4-a716-446655440001"
  ]
}
```

## Example response

```json example-response
{
  "removed": 2,
  "total": 2
}
```

## Fields

| Field | Type | Required | Notes |
| ----- | ---- | -------- | ----- |
| book_ids | array of string (uuid) | Yes | Book ids to remove |

## Errors

| Status | Body | When |
| ------ | ---- | ---- |
| 400 | `{"error": "invalid collection id"}` / `{"error": "invalid request"}` | malformed |
| 400 | `{"error": "smart collections are rule-based..."}` | smart collection |
| 500 | `{"error": "..."}` | unexpected server error |