[Bug]: Using API Update Media Progress, progress will not update. #3081

Closed
opened 2026-04-25 00:13:33 +02:00 by adam · 1 comment
Owner

Originally created by @shanyan-wcx on GitHub (Nov 9, 2025).

What happened?

Use API Update Media Progress to update progress as follows:{
duration: xxx,
currentTime: xxx,
progress: 0.7,
isFinished: false
}The updates for duration, current time, and isFinished are all valid, but progress will not update unless there is a change in isFinished.

What did you expect to happen?

Progress updates correctly.

Steps to reproduce the issue

  1. Use API Update Media Progress to update progress, do not change isFinished.
  2. Progress.progress does not update.
  3. Use API Update Media Progress to update progress, change isFinished to true.
  4. Progress updates correctly.
  5. Use API Update Media Progress to update progress, change isFinished to false.
  6. Progress updates correctly.
  7. Use API Update Media Progress to update progress, do not change isFinished.
  8. Progress.progress does not update.

Audiobookshelf version

v2.30.0

How are you running audiobookshelf?

Docker

What OS is your Audiobookshelf server hosted from?

Linux

If the issue is being seen in the UI, what browsers are you seeing the problem on?

None

Logs

2025-11-09 16:33:52.086

DEBUG

[ApiCacheManager] mediaProgress.afterUpdate: Clearing cache

2025-11-09 16:34:02.362

DEBUG

[ApiCacheManager] mediaProgress.afterUpdate: Clearing cache

2025-11-09 16:34:02.419

DEBUG

[PlaybackSessionManager] syncSession "9ef359b8-b09d-4ba9-be68-4785ad086773" (Device: null null / null) | Total Time Listened: 57.775999784469604

2025-11-09 16:34:02.429

DEBUG

[ApiCacheManager] mediaProgress.afterUpdate: Clearing cache

2025-11-09 16:34:02.438

DEBUG

[ApiCacheManager] Object.afterBulkUpdate: Clearing cache

2025-11-09 16:34:10.995

DEBUG

[ApiCacheManager] count: 0 size: 0

2025-11-09 16:34:11.142

DEBUG

[ApiCacheManager] Cache miss: {"user":"shanyan","url":"/libraries/90e38019-4af9-4855-826f-5a1763ba7696/recent-episodes?limit=50&page=0"}

2025-11-09 16:34:11.698

DEBUG

[ApiCacheManager] count: 1 size: 456508

2025-11-09 16:34:11.706

DEBUG

Loaded 1 of 1 items for "Continue Listening/Reading" in 0.01s

2025-11-09 16:34:11.720

DEBUG

Loaded 10 of 86 episodes for "Newest Episodes" in 0.01s

2025-11-09 16:34:11.725

DEBUG

Loaded 1 of 1 items for "Recently Added" in 0.00s

2025-11-09 16:34:11.732

DEBUG

Loaded 2 of 2 items for "Listen/Read Again" in 0.01s

2025-11-09 16:34:11.732

DEBUG

Loaded 4 personalized shelves in 0.03s

2025-11-09 16:34:11.733

DEBUG

[ApiCacheManager] Cache miss: {"user":"shanyan","url":"/libraries/90e38019-4af9-4855-826f-5a1763ba7696/personalized"}

2025-11-09 16:34:11.733

DEBUG

[ApiCacheManager] Caching with 1800000 ms TTL

2025-11-09 16:34:21.578

DEBUG

[ApiCacheManager] mediaProgress.afterUpdate: Clearing cache

2025-11-09 16:34:21.644

DEBUG

[PlaybackSessionManager] syncSession "9ef359b8-b09d-4ba9-be68-4785ad086773" (Device: null null / null) | Total Time Listened: 76.83299970626831

2025-11-09 16:34:21.666

DEBUG

[ApiCacheManager] Object.afterBulkUpdate: Clearing cache

2025-11-09 16:34:26.477

DEBUG

[ApiCacheManager] count: 0 size: 0

2025-11-09 16:34:26.614

DEBUG

[ApiCacheManager] Cache miss: {"user":"shanyan","url":"/libraries/90e38019-4af9-4855-826f-5a1763ba7696/recent-episodes?limit=50&page=0"}

2025-11-09 16:34:26.986

DEBUG

[ApiCacheManager] count: 1 size: 456508

2025-11-09 16:34:26.997

DEBUG

Loaded 1 of 1 items for "Continue Listening/Reading" in 0.01s

2025-11-09 16:34:27.014

DEBUG

Loaded 10 of 86 episodes for "Newest Episodes" in 0.02s

2025-11-09 16:34:27.021

DEBUG

Loaded 1 of 1 items for "Recently Added" in 0.01s

2025-11-09 16:34:27.029

DEBUG

Loaded 2 of 2 items for "Listen/Read Again" in 0.01s

2025-11-09 16:34:27.029

DEBUG

Loaded 4 personalized shelves in 0.04s

2025-11-09 16:34:27.030

DEBUG

[ApiCacheManager] Cache miss: {"user":"shanyan","url":"/libraries/90e38019-4af9-4855-826f-5a1763ba7696/personalized"}

2025-11-09 16:34:27.031

DEBUG

[ApiCacheManager] Caching with 1800000 ms TTL

2025-11-09 16:34:31.591

DEBUG

[ApiCacheManager] mediaProgress.afterUpdate: Clearing cache

2025-11-09 16:34:31.638

DEBUG

[PlaybackSessionManager] syncSession "9ef359b8-b09d-4ba9-be68-4785ad086773" (Device: null null / null) | Total Time Listened: 86.74799966812134

2025-11-09 16:34:31.652

DEBUG

[ApiCacheManager] Object.afterBulkUpdate: Clearing cache

2025-11-09 16:34:33.961

DEBUG

[ApiCacheManager] count: 0 size: 0

2025-11-09 16:34:34.088

DEBUG

[ApiCacheManager] Cache miss: {"user":"shanyan","url":"/libraries/90e38019-4af9-4855-826f-5a1763ba7696/recent-episodes?limit=50&page=0"}

2025-11-09 16:34:34.609

DEBUG

[ApiCacheManager] count: 1 size: 456508

2025-11-09 16:34:34.619

DEBUG

Loaded 1 of 1 items for "Continue Listening/Reading" in 0.01s

2025-11-09 16:34:34.634

DEBUG

Loaded 10 of 86 episodes for "Newest Episodes" in 0.01s

2025-11-09 16:34:34.640

DEBUG

Loaded 1 of 1 items for "Recently Added" in 0.01s

2025-11-09 16:34:34.647

DEBUG

Loaded 2 of 2 items for "Listen/Read Again" in 0.01s

2025-11-09 16:34:34.648

DEBUG

Loaded 4 personalized shelves in 0.04s

2025-11-09 16:34:34.649

DEBUG

[ApiCacheManager] Cache miss: {"user":"shanyan","url":"/libraries/90e38019-4af9-4855-826f-5a1763ba7696/personalized"}

2025-11-09 16:34:34.649

DEBUG

[ApiCacheManager] Caching with 1800000 ms TTL

Additional Notes

No response

Originally created by @shanyan-wcx on GitHub (Nov 9, 2025). ### What happened? Use API Update Media Progress to update progress as follows:{ duration: xxx, currentTime: xxx, progress: 0.7, isFinished: false }The updates for duration, current time, and isFinished are all valid, but progress will not update unless there is a change in isFinished. ### What did you expect to happen? Progress updates correctly. ### Steps to reproduce the issue 1. Use API Update Media Progress to update progress, do not change isFinished. 2. Progress.progress does not update. 3. Use API Update Media Progress to update progress, change isFinished to true. 4. Progress updates correctly. 5. Use API Update Media Progress to update progress, change isFinished to false. 6. Progress updates correctly. 7. Use API Update Media Progress to update progress, do not change isFinished. 8. Progress.progress does not update. ### Audiobookshelf version v2.30.0 ### How are you running audiobookshelf? Docker ### What OS is your Audiobookshelf server hosted from? Linux ### If the issue is being seen in the UI, what browsers are you seeing the problem on? None ### Logs ```shell 2025-11-09 16:33:52.086 DEBUG [ApiCacheManager] mediaProgress.afterUpdate: Clearing cache 2025-11-09 16:34:02.362 DEBUG [ApiCacheManager] mediaProgress.afterUpdate: Clearing cache 2025-11-09 16:34:02.419 DEBUG [PlaybackSessionManager] syncSession "9ef359b8-b09d-4ba9-be68-4785ad086773" (Device: null null / null) | Total Time Listened: 57.775999784469604 2025-11-09 16:34:02.429 DEBUG [ApiCacheManager] mediaProgress.afterUpdate: Clearing cache 2025-11-09 16:34:02.438 DEBUG [ApiCacheManager] Object.afterBulkUpdate: Clearing cache 2025-11-09 16:34:10.995 DEBUG [ApiCacheManager] count: 0 size: 0 2025-11-09 16:34:11.142 DEBUG [ApiCacheManager] Cache miss: {"user":"shanyan","url":"/libraries/90e38019-4af9-4855-826f-5a1763ba7696/recent-episodes?limit=50&page=0"} 2025-11-09 16:34:11.698 DEBUG [ApiCacheManager] count: 1 size: 456508 2025-11-09 16:34:11.706 DEBUG Loaded 1 of 1 items for "Continue Listening/Reading" in 0.01s 2025-11-09 16:34:11.720 DEBUG Loaded 10 of 86 episodes for "Newest Episodes" in 0.01s 2025-11-09 16:34:11.725 DEBUG Loaded 1 of 1 items for "Recently Added" in 0.00s 2025-11-09 16:34:11.732 DEBUG Loaded 2 of 2 items for "Listen/Read Again" in 0.01s 2025-11-09 16:34:11.732 DEBUG Loaded 4 personalized shelves in 0.03s 2025-11-09 16:34:11.733 DEBUG [ApiCacheManager] Cache miss: {"user":"shanyan","url":"/libraries/90e38019-4af9-4855-826f-5a1763ba7696/personalized"} 2025-11-09 16:34:11.733 DEBUG [ApiCacheManager] Caching with 1800000 ms TTL 2025-11-09 16:34:21.578 DEBUG [ApiCacheManager] mediaProgress.afterUpdate: Clearing cache 2025-11-09 16:34:21.644 DEBUG [PlaybackSessionManager] syncSession "9ef359b8-b09d-4ba9-be68-4785ad086773" (Device: null null / null) | Total Time Listened: 76.83299970626831 2025-11-09 16:34:21.666 DEBUG [ApiCacheManager] Object.afterBulkUpdate: Clearing cache 2025-11-09 16:34:26.477 DEBUG [ApiCacheManager] count: 0 size: 0 2025-11-09 16:34:26.614 DEBUG [ApiCacheManager] Cache miss: {"user":"shanyan","url":"/libraries/90e38019-4af9-4855-826f-5a1763ba7696/recent-episodes?limit=50&page=0"} 2025-11-09 16:34:26.986 DEBUG [ApiCacheManager] count: 1 size: 456508 2025-11-09 16:34:26.997 DEBUG Loaded 1 of 1 items for "Continue Listening/Reading" in 0.01s 2025-11-09 16:34:27.014 DEBUG Loaded 10 of 86 episodes for "Newest Episodes" in 0.02s 2025-11-09 16:34:27.021 DEBUG Loaded 1 of 1 items for "Recently Added" in 0.01s 2025-11-09 16:34:27.029 DEBUG Loaded 2 of 2 items for "Listen/Read Again" in 0.01s 2025-11-09 16:34:27.029 DEBUG Loaded 4 personalized shelves in 0.04s 2025-11-09 16:34:27.030 DEBUG [ApiCacheManager] Cache miss: {"user":"shanyan","url":"/libraries/90e38019-4af9-4855-826f-5a1763ba7696/personalized"} 2025-11-09 16:34:27.031 DEBUG [ApiCacheManager] Caching with 1800000 ms TTL 2025-11-09 16:34:31.591 DEBUG [ApiCacheManager] mediaProgress.afterUpdate: Clearing cache 2025-11-09 16:34:31.638 DEBUG [PlaybackSessionManager] syncSession "9ef359b8-b09d-4ba9-be68-4785ad086773" (Device: null null / null) | Total Time Listened: 86.74799966812134 2025-11-09 16:34:31.652 DEBUG [ApiCacheManager] Object.afterBulkUpdate: Clearing cache 2025-11-09 16:34:33.961 DEBUG [ApiCacheManager] count: 0 size: 0 2025-11-09 16:34:34.088 DEBUG [ApiCacheManager] Cache miss: {"user":"shanyan","url":"/libraries/90e38019-4af9-4855-826f-5a1763ba7696/recent-episodes?limit=50&page=0"} 2025-11-09 16:34:34.609 DEBUG [ApiCacheManager] count: 1 size: 456508 2025-11-09 16:34:34.619 DEBUG Loaded 1 of 1 items for "Continue Listening/Reading" in 0.01s 2025-11-09 16:34:34.634 DEBUG Loaded 10 of 86 episodes for "Newest Episodes" in 0.01s 2025-11-09 16:34:34.640 DEBUG Loaded 1 of 1 items for "Recently Added" in 0.01s 2025-11-09 16:34:34.647 DEBUG Loaded 2 of 2 items for "Listen/Read Again" in 0.01s 2025-11-09 16:34:34.648 DEBUG Loaded 4 personalized shelves in 0.04s 2025-11-09 16:34:34.649 DEBUG [ApiCacheManager] Cache miss: {"user":"shanyan","url":"/libraries/90e38019-4af9-4855-826f-5a1763ba7696/personalized"} 2025-11-09 16:34:34.649 DEBUG [ApiCacheManager] Caching with 1800000 ms TTL ``` ### Additional Notes _No response_
adam added the bug label 2026-04-25 00:13:33 +02:00
adam closed this issue 2026-04-25 00:13:33 +02:00
Author
Owner

@Vito0912 commented on GitHub (Nov 9, 2025):

Please note that the progress endpoint only really is intended for setting finished. This endpoint should not be used to set actual progress.
For this the session (and or /sync) endpoint should be used.

But if you REALLY (and you should ONLY do it e.g. for an single action such as setting the progress of a book manually from an interface, which should not create a session) you can do it with the progress endpoint.
Do not set isFinished at all then. If you set isFinished to false you set it to false and do not update the progress

Please close this issue if you issue is resolved. The docs are sadly outdated, there are issues for that, so while this is not mentioned in the docs, this is intended behaviour

@Vito0912 commented on GitHub (Nov 9, 2025): Please note that the progress endpoint only really is intended for setting finished. This endpoint should not be used to set actual progress. For this the session (and or /sync) endpoint should be used. But if you REALLY (and you should ONLY do it e.g. for an single action such as setting the progress of a book manually from an interface, which should not create a session) you can do it with the progress endpoint. Do not set isFinished at all then. If you set isFinished to false you set it to false and do not update the progress Please close this issue if you issue is resolved. The docs are sadly outdated, there are issues for that, so while this is not mentioned in the docs, this is intended behaviour
Sign in to join this conversation.
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: starred/audiobookshelf#3081