Story Playlists
Create a story playlist
POST
https://api.tunio.ai/A manual playlist (add stories to it next) or a filter playlist (every story of a category, language, age range and length). Schedule it with POST /v1/stream-schedule/content/slot, content_type story_playlist.
Request body
The playlist
| Name | Type | Description |
|---|---|---|
| filter | object | Filter picks stories for a filter playlist; empty fields do not narrow. |
| age_max | integer | - |
| age_min | integer | Ages the book is rated for: AgeMin ≤ its age ≤ AgeMax (0, 6, 12, 16, 18). |
| category | string | - |
| duration_max | integer | The longest book, in seconds. |
| language | string | - |
| intro_uuid | string | 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. |
| kind | string | Kind is manual (stories added one by one, in order) or filter (every story matching Filter). |
| outro_uuid | string | - |
| title | string | 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
| Name | Type | Description |
|---|---|---|
| playlist | object | - |
| created_at | string | - |
| filter | object | - |
| intro_uuid | string | - |
| kind | string | - |
| outro_uuid | string | - |
| stories | integer | Stories in a manual playlist. |
| title | string | - |
| updated_at | string | - |
| uuid | string | - |
| success | boolean | - |
| Name | Type | Description |
|---|---|---|
| message | string | Message contains human readable error details. |
| success | boolean | Success is always false for error payloads. |
| Name | Type | Description |
|---|---|---|
| message | string | Message contains human readable error details. |
| success | boolean | Success is always false for error payloads. |