Skip to content

Manually set reading status for a book

PATCH
/api/library/{id}/reading-status

Override the computed reading status with user-supplied values. Sticky against KoReader sync until the user clears the override via DELETE.

Parameters

Path Parameters

id*

Book UUID

Type
string
Required
Format
"uuid"

Request Body

application/json
JSON
{
  
"status": "string",
  
"startedAt": "string",
  
"finishedAt": "string",
  
"pausedAt": "string"
}

Responses

Override applied; returns the updated effective progress aggregate

application/json
JSON
{
  
"percentage": 0,
  
"status": "string",
  
"lastDevice": "string",
  
"lastTimestamp": 0,
  
"startedAt": "string",
  
"finishedAt": "string",
  
"pausedAt": "string",
  
"manuallySet": true,
  
"externallySet": true
}

Samples