Story Playlists

Update a story playlist

PATCH
https://api.tunio.ai/v1/story-playlists/{uuid}

Its title, filter, intro and outro (an update always sets both). The kind does not change.

Path parameters

NameTypeDescription
uuidRequiredstringPlaylist UUID

Request body

The playlist

NameTypeDescription
filterobject
Filter picks stories for a filter playlist; empty fields do not narrow.
age_maxinteger
-
age_mininteger
Ages the book is rated for: AgeMin ≤ its age ≤ AgeMax (0, 6, 12, 16, 18).
categorystring
-
duration_maxinteger
The longest book, in seconds.
languagestring
-
intro_uuidstring
IntroUUID and OutroUUID are files of the account's library aired before and after a slot's stories; null for none. An update always sets both.
kindstring
Kind is manual (stories added one by one, in order) or filter (every story matching Filter).
outro_uuidstring
-
titlestring
Title of the playlist, 1-200 characters.
Request example
01{
02 "filter": {
03 "age_max": 0,
04 "age_min": 0,
05 "category": "string",
06 "duration_max": 0,
07 "language": "string"
08 },
09 "intro_uuid": "string",
10 "kind": "filter",
11 "outro_uuid": "string",
12 "title": "Bedtime stories"
13}

Responses

NameTypeDescription
playlistobject
-
created_atstring
-
filterobject
-
intro_uuidstring
-
kindstring
-
outro_uuidstring
-
storiesinteger
Stories in a manual playlist.
titlestring
-
updated_atstring
-
uuidstring
-
successboolean
-
NameTypeDescription
messagestring
Message contains human readable error details.
successboolean
Success is always false for error payloads.
NameTypeDescription
messagestring
Message contains human readable error details.
successboolean
Success is always false for error payloads.