Stream Music Schedule

Replace music schedule

PUT
https://api.tunio.ai/v1/stream-music-schedule/{stream_id}

Replaces every music slot of the stream with the given set, atomically. Each slot repeats weekly; give its start either as start_at (only its weekday and time are kept) or as day_of_week + start_time, and its end either as duration_min or as end_time. Every playlist and jingle playlist must belong to the caller's library, and no two slots of the set may overlap on the same day (the rule of the single-slot endpoint, applied to the whole set). slots is required: send it as an empty array to clear the schedule. An omitted or null slots is refused with 400 slots_required and nothing is written. With dry_run=true nothing is written: the response says whether the set is valid, lists the conflicts and the diff against the current schedule. With dry_run=false a conflicting set is refused with 409 and nothing is written. A valid set is applied after the stream's current schedule (music and content) is saved as a private schedule profile, returned as snapshot_profile_id; apply it with POST /v1/schedule-profiles/{profile_id}/apply to roll back. The last 20 automatic snapshots per stream are kept. Slots that do not change keep their slot_id.

Path parameters

NameTypeDescription
stream_idRequiredstringStream ID

Request body

Complete new schedule

NameTypeDescription
dry_runboolean
true validates and reports the diff without writing anything.
slotsRequiredarray
The complete new schedule, up to 500 slots; an empty array clears it. Required: an omitted or null slots is refused with slots_required.
[item]Requiredobject
-
Request example
01{
02 "dry_run": true,
03 "slots": [
04 {
05 "day_of_week": 1,
06 "duration_min": 180,
07 "end_time": "12:00",
08 "jingle_playlist_id": "2e8a4b1c-9d3f-4c6a-8b7e-5f0a1c2d3e4f",
09 "jingles_tracks_interval": 2,
10 "let_static_finish": false,
11 "playlist_id": "6f1d1d4c-8c47-4b9f-a1f4-7c1f0b2f9a11",
12 "start_at": "2026-11-09T09:00:00+03:00",
13 "start_time": "09:00",
14 "transition": "crossfade",
15 "volume": 1
16 }
17 ]
18}

Responses

NameTypeDescription
conflictsarray
Every overlapping pair of requested slots; empty when valid.
[item]Requiredobject
-
diffobject
How the request differs from the current schedule.
addedarray
Requested slots that are not in the current schedule.
removedarray
Current slots that the request does not keep.
unchanged_countinteger
How many current slots stay as they are (and keep their slot_id).
dry_runboolean
Echoes the request's dry_run.
messagestring
schedule_conflict on a 409; absent otherwise.
snapshot_profile_idstring
UUID of the private schedule profile holding the stream's schedule (music and content) as it was before this write; apply it with POST /v1/schedule-profiles/{profile_id}/apply to roll back. Null on dry runs and on a 409.
successboolean
true, except on a 409.
validboolean
false when slots of the request overlap each other.
NameTypeDescription
messagestring
Error code.
slot_indexinteger
Index (0-based) in the request's slots of the slot at fault; absent for errors about the whole request.
successboolean
Always false.
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.
slot_indexinteger
Index (0-based) in the request's slots of the slot at fault; absent for errors about the whole request.
successboolean
Always false.
NameTypeDescription
conflictsarray
Every overlapping pair of requested slots; empty when valid.
[item]Requiredobject
-
diffobject
How the request differs from the current schedule.
addedarray
Requested slots that are not in the current schedule.
removedarray
Current slots that the request does not keep.
unchanged_countinteger
How many current slots stay as they are (and keep their slot_id).
dry_runboolean
Echoes the request's dry_run.
messagestring
schedule_conflict on a 409; absent otherwise.
snapshot_profile_idstring
UUID of the private schedule profile holding the stream's schedule (music and content) as it was before this write; apply it with POST /v1/schedule-profiles/{profile_id}/apply to roll back. Null on dry runs and on a 409.
successboolean
true, except on a 409.
validboolean
false when slots of the request overlap each other.
NameTypeDescription
messagestring
Error code or human-readable error details.
successboolean
Always false for error payloads.