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.
路径参数
| 名称 | 类型 | 说明 |
|---|---|---|
| uuidRequired | string | Playlist UUID |
请求体
The fields to change
| 名称 | 类型 | 说明 |
|---|---|---|
| filter | object | 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_max | integer | Highest age rating of the stories: 0, 6, 12, 16 or 18, not below age_min; absent for no
upper bound. |
| age_min | integer | Lowest age rating of the stories: 0, 6, 12, 16 or 18; absent for no lower bound. |
| category | string | Category slug (lowercase letters, digits and dashes, up to 40), as in the story library;
absent or empty for any. |
| duration_max | integer | Longest story to take, in seconds, 60-36000; absent or 0 for any length. |
| language | string | Language code such as en or pt-BR; absent or empty for any. |
| intro_uuid | string | UUID of a file of the caller's library aired before a slot's stories; null or an empty string
removes the intro. |
| outro_uuid | string | UUID of a file of the caller's library aired after a slot's stories; null or an empty string
removes the outro. |
| title | string | 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}
响应
| 名称 | 类型 | 说明 |
|---|---|---|
| playlist | object | The playlist. |
| created_at | string | When the playlist was created. |
| filter | object | The filter of a filter playlist; empty for a manual one. |
| intro_asset_title | string | Title of the intro file; absent when there is none. |
| intro_uuid | string | UUID of the file aired before a slot's stories, or null. |
| kind | string | manual or filter. |
| outro_asset_title | string | Title of the outro file; absent when there is none. |
| outro_uuid | string | UUID of the file aired after a slot's stories, or null. |
| stories | integer | Number of stories in a manual playlist; 0 for a filter playlist, and in create and update responses. |
| title | string | Title of the playlist. |
| updated_at | string | When the playlist was last changed. |
| uuid | string | UUID of the playlist; use it as content_id of a story_playlist schedule slot. |
| success | boolean | Always true on success. |
| 名称 | 类型 | 说明 |
|---|---|---|
| message | string | Error code or human-readable error details. |
| success | boolean | Always false for error payloads. |
| 名称 | 类型 | 说明 |
|---|---|---|
| message | string | Error code or human-readable error details. |
| success | boolean | Always false for error payloads. |
| 名称 | 类型 | 说明 |
|---|---|---|
| message | string | Error code or human-readable error details. |
| success | boolean | Always false for error payloads. |
| 名称 | 类型 | 说明 |
|---|---|---|
| message | string | Error code or human-readable error details. |
| success | boolean | Always false for error payloads. |
| 名称 | 类型 | 说明 |
|---|---|---|
| message | string | Error code or human-readable error details. |
| success | boolean | Always false for error payloads. |