Stream Content Schedule

Create content schedule time slot

POST
https://api.tunio.ai/v1/stream-schedule/content/slot

Adds 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.

Request body

Create content schedule request

NameTypeDescription
content_idstring
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_typeRequiredstring
Kind of content the slot airs.
datestring
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_weekinteger
Day of the week a weekly slot repeats on: 1 = Monday ... 7 = Sunday. Required unless date is set; ignored when it is.
forceboolean
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.
metaobject
Per-kind options of the slot; see the fields for which content types each applies to. Optional except for announcement_block, which requires mode.
countinteger
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.
modestring
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_timeboolean
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.
playbackobject
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.
preciseboolean
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.
repeatboolean
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_timeRequiredstring
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_idRequiredstring
UUID of the stream that owns the schedule.
Request example
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": false
19 },
20 "start_time": "08:00",
21 "stream_id": "5a0c8a52-2f7e-4c1b-8d3e-9f0a1b2c3d4e"
22}

Responses

NameTypeDescription
slot_idstring
UUID of the created slot; use it to delete the slot.
successboolean
Always true on success.
NameTypeDescription
messagestring
Error code or human-readable error details.
successboolean
Always false for error payloads.
NameTypeDescription
messagestring
Error code or human-readable error details.
successboolean
Always false for error payloads.
NameTypeDescription
messagestring
Error code or human-readable error details.
successboolean
Always false for error payloads.
NameTypeDescription
messagestring
Error code or human-readable error details.
successboolean
Always false for error payloads.
NameTypeDescription
messagestring
Error code or human-readable error details.
successboolean
Always false for error payloads.
NameTypeDescription
messagestring
Error code or human-readable error details.
successboolean
Always false for error payloads.