Story Playlists
Get a story playlist
GET
https://api.tunio.ai/ v1/ story-playlists/ {uuid}The playlist with its stories: all of a manual playlist's, in order (cursor and limit are ignored), or a filter playlist's a page at a time.
Path parameters
| Name | Type | Description |
|---|---|---|
| uuidRequired | string | Playlist UUID |
Query parameters
| Name | Type | Description |
|---|---|---|
| cursor | string | next_cursor from the previous page (filter playlists) |
| limit | integer | Page size, 1-100; other values fall back to 30 (filter playlists) |
Responses
| Name | Type | Description |
|---|---|---|
| missing | array | Manual playlist only: UUIDs of stories that are no longer available, shown so they can be removed. |
| [item]Required | string | - |
| next_cursor | string | Filter playlist: cursor of the next page, null on the last page. Always null for a manual playlist. |
| 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. |
| stories | array | A manual playlist's stories in order, or a page of a filter playlist's stories. |
| [item]Required | object | - |
| success | boolean | Always true on success. |
| total | integer | Manual playlist: the number of available stories returned. Filter playlist: how many stories match. |
| Name | Type | Description |
|---|---|---|
| message | string | Error code or human-readable error details. |
| success | boolean | Always false for error payloads. |
| Name | Type | Description |
|---|---|---|
| message | string | Error code or human-readable error details. |
| success | boolean | Always false for error payloads. |
| Name | Type | Description |
|---|---|---|
| message | string | Error code or human-readable error details. |
| success | boolean | Always false for error payloads. |
| Name | Type | Description |
|---|---|---|
| message | string | Error code or human-readable error details. |
| success | boolean | Always false for error payloads. |
| Name | Type | Description |
|---|---|---|
| message | string | Error code or human-readable error details. |
| success | boolean | Always false for error payloads. |
| Name | Type | Description |
|---|---|---|
| message | string | Error code or human-readable error details. |
| success | boolean | Always false for error payloads. |