Stream Content Schedule
Create content schedule time slot
https://api.tunio.ai/ v1/ stream-schedule/ content/ slotAdds one content slot to a stream: weekly, airing every week on day_of_week at start_time in the stream's timezone, or one-off with date, airing on that date only and replacing, on that date, a weekly slot that starts at the same time. Any content kind of the schedule can be scheduled; meta carries the per-kind options (for example the episode pick of a podcast, the order and number of stories of a story playlist, or how an announcement goes on air). Content slots conflict only when they start at the same time on the same day: two weekly slots of one weekday, or two one-off slots of one date. Such a conflict is refused with 409 unless force is true, which replaces the slot already there.
请求体
Create content schedule request
| 名称 | 类型 | 说明 |
|---|---|---|
| content_id | string | UUID of the item of the given content_type in the caller's library (for story_playlist, a story
playlist of the account). Required for every content type except time_announcement, where it is ignored. |
| content_typeRequired | string | Kind of content the slot airs. |
| date | string | Date of a one-off slot, YYYY-MM-DD in the stream's timezone, from today up to a year ahead. The slot plays on that day only and, on that day, replaces a weekly slot starting at the same time. Omit for a weekly slot. |
| day_of_week | integer | Day of the week a weekly slot repeats on: 1 = Monday ... 7 = Sunday. Required unless date is set; ignored when it is. |
| force | boolean | When a slot already starts at exactly this start_time on the same day_of_week (weekly) or the same
date (one-off), true replaces it and false (default) answers 409. Slots at other times are never
touched: content slots conflict only on the same start time. A one-off slot never conflicts with a
weekly one. |
| meta | object | Per-kind options of the slot; see the fields for which content types each applies to. Optional
except for announcement_block, which requires mode. |
| count | integer | How many items one trigger of the slot plays. announcement_block: items of the block, 0 =
all of them. story_playlist: stories, 1-10 (0 = 1). Ignored for other content types. Always
present in responses, since 0 is meaningful. |
| mode | string | How the slot picks its items. podcast: last (the latest episode, default) or random.
announcement_block: sequential or random (required). story_playlist: sequential (the
playlist's order; newest first for a filter playlist, default), newest or random.
Ignored for other content types. |
| play_current_time | boolean | Plays a time announcement ("it is 10:30") before the slot's content. Not allowed on jingle
and jingle_playlist slots (invalid_meta); refused with time_announcements_unavailable when
the stream's language has no time announcements. For a slot that only announces the time,
use content_type time_announcement instead. |
| playback | object | announcement and announcement_block only (any other content type is rejected with
invalid_meta): how the slot goes on air. mode cut (default) interrupts the song at the
slot's time, after_track waits for the song to end, voiceover reads it over the song: the
music ducks to duck (0-1) over fade_down seconds and comes back over fade_up seconds (0-10 each), and
the same song goes on. Voice-over needs a plan with advanced stream sound; without it the
announcement plays after the song. |
| precise | boolean | jingle and jingle_playlist only: true interrupts the track on air and plays the jingle at
once; false (default) plays it after the current track. Ignored for other content types. |
| repeat | boolean | story_playlist only: false (default) airs each story once per station and skips the slot
when none are left; true lets stories already aired on the station air again, least
recently aired first, once every story has aired. |
| start_timeRequired | string | Slot start, HH:MM or HH:MM:SS in the stream's timezone. A weekly slot fires at this time every week on day_of_week, a one-off slot on its date. |
| stream_idRequired | string | UUID of the stream that owns the schedule. |
01{02 "content_id": "3c1e2f90-7d4b-4a8e-9f21-6b5d4c3a2e10",03 "content_type": "announcement",04 "date": "2026-12-31",05 "day_of_week": 1,06 "force": false,07 "meta": {08 "count": 0,09 "mode": "random",10 "play_current_time": false,11 "playback": {12 "duck": 0.2,13 "fade_down": 0.8,14 "fade_up": 1.5,15 "mode": "voiceover"16 },17 "precise": false,18 "repeat": false19 },20 "start_time": "08:00",21 "stream_id": "5a0c8a52-2f7e-4c1b-8d3e-9f0a1b2c3d4e"22}
响应
| 名称 | 类型 | 说明 |
|---|---|---|
| slot_id | string | UUID of the created slot; use it to delete the 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. |
| 名称 | 类型 | 说明 |
|---|---|---|
| message | string | Error code or human-readable error details. |
| success | boolean | Always false for error payloads. |