Skip to content

Commit

Permalink
[docs] Document changing track attribs time_played/time_skipped
Browse files Browse the repository at this point in the history
  • Loading branch information
ejurgensen committed Oct 17, 2024
1 parent 12f7286 commit 3b28960
Showing 1 changed file with 5 additions and 1 deletion.
6 changes: 5 additions & 1 deletion docs/json-api.md
Original file line number Diff line number Diff line change
Expand Up @@ -1622,7 +1622,7 @@ curl -X GET "http://localhost:3689/api/library/tracks/27/playlists"

### Update track properties

Change properties of one or more tracks (supported properties are "rating", "play_count", "skip_count" and "usermark")
Change properties of one or more tracks.

**Endpoint**

Expand All @@ -1636,6 +1636,8 @@ PUT /api/library/tracks
| --------------- | -------- | ----------------------- |
| tracks | array | Array of track objects |

See query parameters for update of a single track for a list of properties that can be modified.

**Response**

On success returns the HTTP `204 No Content` success status response code.
Expand Down Expand Up @@ -1666,6 +1668,8 @@ PUT /api/library/tracks/{id}
| play_count | Either `increment` or `reset` or the new count. `increment` will increment `play_count` and update `time_played`, `reset` will set `play_count` and `skip_count` to zero and delete `time_played` and `time_skipped` |
| skip_count | The new skip count |
| usermark | The new usermark (>= 0) |
| time_played | Modify last played timestamp |
| time_skipped | Modify last skipped timestamp |

**Response**

Expand Down

0 comments on commit 3b28960

Please sign in to comment.