---
method: POST
path: /api/scanner/stop
auth: jwt+admin
area: scanner
---
<!-- source: internal/handlers/scanner.go:168 Handler.StopScanner -->

# Stop Scanner

Stop the automated background scanner for a library.

**Endpoint**: `POST /api/scanner/stop`
**Auth**: Required (Admin only)
**Content-Type**: `application/json`

## Request Body

| Field      | Type          | Required | Description                   |
| ---------- | ------------- | -------- | ----------------------------- |
| library_id | string (UUID) | Yes      | Library UUID to stop scanning |

### Example Request

## Response (200 OK)

```json example-response
{
  "message": "Scanner stopped successfully"
}
```

## Error Responses

| Code | Description                          |
| ---- | ------------------------------------ |
| 400  | Invalid request data                 |
| 401  | Invalid or expired token             |
| 403  | User does not have admin privileges  |
| 404  | Library not found                    |
| 400  | Scanner not running for this library |