Story Playlists

Preview a story playlist filter

POST
https://api.tunio.ai/v1/story-playlists/preview

The stories a filter playlist would air, before it is saved, a page at a time.

Query parameters

NameTypeDescription
cursorstringCursor from the previous page
limitstringPage size

Request body

The filter (title and kind are not needed)

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
next_cursorstring
-
storiesarray
-
[item]Requiredobject
-
successboolean
-
totalinteger
-
NameTypeDescription
messagestring
Message contains human readable error details.
successboolean
Success is always false for error payloads.