---
method: GET
path: /api/admin/hash-conflicts
auth: jwt+admin
area: admin
---
<!-- source: internal/handlers/hash_conflicts.go:69 HashConflictsHandler.ListHashConflicts -->

# Hash Conflicts (API)

Lists pending content-duplicate groups (same library + SHA-256 at different
paths) with per-item usage counts.

## Example response

```json example-response
{
  "conflicts": [
    {
      "id": "uuid",
      "library_id": "uuid",
      "library_name": "Manga",
      "sha256": "abc123...",
      "created_at": "2026-10-24T13:57:01Z",
      "items": [
        {
          "id": "uuid",
          "title": "Book Title",
          "author": "Author",
          "file_path": "/path/to/book.epub",
          "file_size": 12345,
          "created_at": "2026-10-24T13:57:01Z",
          "progress_count": 0,
          "highlight_count": 0,
          "bookmark_count": 0,
          "note_count": 0,
          "collection_count": 0
        }
      ]
    }
  ],
  "total": 1
}
```

## Errors

| Status | Body | When |
| ------ | ---- | ---- |
| 401 | `{"error": "unauthorized"}` | no/invalid JWT |
| 403 | `{"error": "admin access required"}` | non-admin |
| 500 | `{"error": "failed to list hash conflicts"}` | unexpected server error |