reader

Update the listening position

Conflicts resolve on lastReadAtMs, not arrival order: an update older than the stored one is ignored rather than applied, so a device that was offline cannot rewind a position set somewhere else.

put/v1/reader/audiobooks/{audiobookId}/progress

Request

  • Base URL: https://api.ditto.audio (the document declares no server; this is the origin it was published from)
  • URL: https://api.ditto.audio/v1/reader/audiobooks/{audiobookId}/progress
  • Auth: HTTP bearer

Path parameters

audiobookIdstring required

Request body

chapterIndexnumber
paragraphIndexnumber

Segment within the chapter.

cfistring

An epub.js CFI, if you have one.

percentCompletenumber

0..1

totalReadingTimeMsnumber

Total listening/reading time, ms.

lastReadAtMsnumber

Client clock, ms epoch. Last-write-wins is resolved on THIS, not on arrival order — an update older than the stored one is ignored, so a device coming back online cannot rewind a position set elsewhere.

Changes

No recorded changes to this operation across all 1 revision of this API.