---
method: POST
path: /api/sync/auto-link-books
auth: jwt
area: book-matching
---
<!-- source: internal/handlers/book_matching.go:316 Handler.AutoLinkBooks -->

# Auto Link Books

Automatically link books to media items based on matching metadata.

**Endpoint**: `POST /api/sync/auto-link-books`
**Auth**: Required
**Content-Type**: `application/json`

## Request Body

| Field     | Type          | Required | Description                                        |
| --------- | ------------- | -------- | -------------------------------------------------- |
| device_id | string (UUID) | Yes      | Device UUID                                        |
| threshold | float         | No       | Match confidence threshold (0.0-1.0, default: 0.7) |

### Example Request

```json example-request
{
  "confidence_threshold": 0.8,
  "limit": 100
}
```

## Response (200 OK)

```json example-response
{
  "auto_linked": null,
  "results": null
}
```

## Error Responses

| Code | Description              |
| ---- | ------------------------ |
| 400  | Invalid request data     |
| 401  | Invalid or expired token |
| 404  | Device not found         |