Stream Music Schedule

Create music schedule slot

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

Adds a weekly music slot to the stream: the playlist plays every week on the weekday and at the time given by start_at (in the stream's timezone) for duration_min minutes. start_at only picks the weekday and time; its date is discarded, and there are no one-off slots. A slot that overlaps existing music slots of that day is refused with 409 unless force is true, which deletes every overlapping slot first.

Request body

Create schedule slot request

NameTypeDescription
duration_minRequiredinteger
Slot length in minutes, at least 1. The slot must end before midnight in the stream's timezone.
forceboolean
When the slot overlaps existing music slots of that day, true deletes every overlapping slot and adds this one; false (default) answers 409.
playlist_idRequiredstring
UUID of a playlist owned by the caller.
start_atRequiredstring (date-time)
RFC3339 datetime that only picks the weekday and time of the weekly slot: it is converted to the stream's timezone, its weekday and time of day are kept and the date is discarded. The slot plays every week from then on, including weeks before that date.
stream_idRequiredstring
UUID of the stream.
volumenumber
Master volume of the slot, 0..1 (default 1); 0 makes the slot silent.
Request example
01{
02 "duration_min": 180,
03 "force": false,
04 "playlist_id": "6f1d1d4c-8c47-4b9f-a1f4-7c1f0b2f9a11",
05 "start_at": "2026-11-09T09:00:00+03:00",
06 "stream_id": "5a0c8a52-2f7e-4c1b-8d3e-9f0a1b2c3d4e",
07 "volume": 1
08}

Responses

NameTypeDescription
slot_idstring
UUID of the created 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.