Stream Music Schedule
Replace music schedule
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
| Name | Type | Description |
|---|---|---|
| stream_idRequired | string | Stream ID |
Request body
Complete new schedule
| Name | Type | Description |
|---|---|---|
| dry_run | boolean | true validates and reports the diff without writing anything. |
| slotsRequired | array | 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]Required | object | - |
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": 116 }17 ]18}
Responses
| Name | Type | Description |
|---|---|---|
| conflicts | array | Every overlapping pair of requested slots; empty when valid. |
| [item]Required | object | - |
| diff | object | How the request differs from the current schedule. |
| added | array | Requested slots that are not in the current schedule. |
| removed | array | Current slots that the request does not keep. |
| unchanged_count | integer | How many current slots stay as they are (and keep their slot_id). |
| dry_run | boolean | Echoes the request's dry_run. |
| message | string | schedule_conflict on a 409; absent otherwise. |
| snapshot_profile_id | string | 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. |
| success | boolean | true, except on a 409. |
| valid | boolean | false when slots of the request overlap each other. |
| Name | Type | Description |
|---|---|---|
| message | string | Error code. |
| slot_index | integer | Index (0-based) in the request's slots of the slot at fault; absent for errors about the
whole request. |
| success | boolean | Always false. |
| 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. |
| slot_index | integer | Index (0-based) in the request's slots of the slot at fault; absent for errors about the
whole request. |
| success | boolean | Always false. |
| Name | Type | Description |
|---|---|---|
| conflicts | array | Every overlapping pair of requested slots; empty when valid. |
| [item]Required | object | - |
| diff | object | How the request differs from the current schedule. |
| added | array | Requested slots that are not in the current schedule. |
| removed | array | Current slots that the request does not keep. |
| unchanged_count | integer | How many current slots stay as they are (and keep their slot_id). |
| dry_run | boolean | Echoes the request's dry_run. |
| message | string | schedule_conflict on a 409; absent otherwise. |
| snapshot_profile_id | string | 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. |
| success | boolean | true, except on a 409. |
| valid | boolean | false when slots of the request overlap each other. |
| Name | Type | Description |
|---|---|---|
| message | string | Error code or human-readable error details. |
| success | boolean | Always false for error payloads. |