Files
bookhoard/docs/developer/api/conflicts/get_conflict.md
T
john-okeefe b44e4e4709 docs: remove Phase X placeholders from API documentation
Clean up API documentation files by removing Phase X references:

Remove 'API Explorer will be inserted here in Phase X' placeholders from:
- 70+ API endpoint documentation files
- Authentication endpoints (login, logout, register, refresh)
- User endpoints (profile, settings, password)
- Device endpoints (registration, sync, shelves)
- Library endpoints (CRUD, folders, visibility)
- Media endpoints (items, progress, highlights, notes)
- Admin endpoints (users, analytics)
- Sync endpoints (Kobo, KOReader)
- OPDS endpoints
- Scanner endpoints
- Queue endpoints

These placeholders were from planning documents and have no meaning
to API consumers. The documentation is now clean and ready for use.
2026-02-13 21:50:44 -05:00

1.5 KiB

Get Conflict Details

Get detailed information about a specific conflict.

Endpoint: GET /api/conflicts/:id Auth: Required

Path Parameters

Parameter Type Required Description
id string (UUID) Yes Conflict UUID

Request Headers

Header Type Required Description
Authorization string Yes Bearer token

Example Request

GET /api/conflicts/550e8400-e29b-41d4-a716-446655440000
Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...

Response (200 OK)

{
  "id": "uuid",
  "media_item": {
    "id": "book-uuid",
    "title": "Sample Book",
    "authors": ["Author Name"]
  },
  "device_progress": {
    "device_id": "device-uuid",
    "device_name": "My Kobo",
    "percentage": 75,
    "position": 1234,
    "page": 150,
    "updated_at": "2026-02-08T10:00:00Z"
  },
  "server_progress": {
    "percentage": 50,
    "position": 800,
    "page": 100,
    "updated_at": "2026-02-08T09:00:00Z"
  },
  "device_bookmarks": [
    {
      "position": 1234,
      "text": "Interesting passage",
      "created_at": "2026-02-08T10:00:00Z"
    }
  ],
  "server_bookmarks": [
    {
      "position": 800,
      "text": "Another passage",
      "created_at": "2026-02-07T15:00:00Z"
    }
  ],
  "status": "active",
  "created_at": "2026-02-08T10:00:00Z"
}

Error Responses

Code Description
401 Invalid or expired token
404 Conflict not found