---
method: POST
path: /api/collections/bulk-add-books
auth: jwt
area: collections
---
<!-- source: internal/handlers/collections.go:1133 CollectionHandler.HandleBulkAddBooks -->

# Bulk Add Books

Adds books to multiple collections in one request.

## Example request

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

## Example response

```json example-response
{
  "results": [],
  "total": 1
}
```

## Fields

| Field | Type | Required | Notes |
| ----- | ---- | -------- | ----- |
| operations | array | Yes | List of {collection_id, book_ids} |
| operations[].collection_id | string (uuid) | Yes | Target collection |
| operations[].book_ids | array of string (uuid) | Yes | Books to add |

## Errors

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