Story Playlists

Update a story playlist

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

Changes only the fields sent: title, filter (a filter playlist's, replaced as a whole), intro_uuid and outro_uuid. A field left out keeps its value; intro_uuid or outro_uuid sent as null or an empty string removes that file. The kind does not change, and kind in the body is ignored.

路径参数

名称类型说明
uuidRequiredstringPlaylist UUID

请求体

The fields to change

名称类型说明
filterobject
New filter of a filter playlist, replacing the whole current filter; absent or empty fields of it do not narrow. Ignored for a manual playlist.
age_maxinteger
Highest age rating of the stories: 0, 6, 12, 16 or 18, not below age_min; absent for no upper bound.
age_mininteger
Lowest age rating of the stories: 0, 6, 12, 16 or 18; absent for no lower bound.
categorystring
Category slug (lowercase letters, digits and dashes, up to 40), as in the story library; absent or empty for any.
duration_maxinteger
Longest story to take, in seconds, 60-36000; absent or 0 for any length.
languagestring
Language code such as en or pt-BR; absent or empty for any.
intro_uuidstring
UUID of a file of the caller's library aired before a slot's stories; null or an empty string removes the intro.
outro_uuidstring
UUID of a file of the caller's library aired after a slot's stories; null or an empty string removes the outro.
titlestring
New title, 1-200 characters.
请求示例
01{
02 "filter": {
03 "age_max": 12,
04 "age_min": 0,
05 "category": "fantasy",
06 "duration_max": 1800,
07 "language": "en"
08 },
09 "intro_uuid": "7a1b2c3d-4e5f-4a6b-8c7d-9e0f1a2b3c4d",
10 "outro_uuid": "5c6d7e8f-9a0b-4c1d-8e2f-3a4b5c6d7e8f",
11 "title": "Bedtime stories"
12}

响应

名称类型说明
playlistobject
The playlist.
created_atstring
When the playlist was created.
filterobject
The filter of a filter playlist; empty for a manual one.
intro_asset_titlestring
Title of the intro file; absent when there is none.
intro_uuidstring
UUID of the file aired before a slot's stories, or null.
kindstring
manual or filter.
outro_asset_titlestring
Title of the outro file; absent when there is none.
outro_uuidstring
UUID of the file aired after a slot's stories, or null.
storiesinteger
Number of stories in a manual playlist; 0 for a filter playlist, and in create and update responses.
titlestring
Title of the playlist.
updated_atstring
When the playlist was last changed.
uuidstring
UUID of the playlist; use it as content_id of a story_playlist schedule slot.
successboolean
Always true on success.
名称类型说明
messagestring
Error code or human-readable error details.
successboolean
Always false for error payloads.
名称类型说明
messagestring
Error code or human-readable error details.
successboolean
Always false for error payloads.
名称类型说明
messagestring
Error code or human-readable error details.
successboolean
Always false for error payloads.
名称类型说明
messagestring
Error code or human-readable error details.
successboolean
Always false for error payloads.
名称类型说明
messagestring
Error code or human-readable error details.
successboolean
Always false for error payloads.