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.

请求体

Create schedule slot request

名称类型说明
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.
请求示例
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}

响应

名称类型说明
slot_idstring
UUID of the created slot.
successboolean
Always true on success.
名称类型说明
messagestring
Error code or human-readable error details.
successboolean
Always false for error payloads.
名称类型说明
messagestring
Error code or human-readable error details.
successboolean
Always false for error payloads.
名称类型说明
messagestring
Error code or human-readable error details.
successboolean
Always false for error payloads.
名称类型说明
messagestring
Error code or human-readable error details.
successboolean
Always false for error payloads.
名称类型说明
messagestring
Error code or human-readable error details.
successboolean
Always false for error payloads.
名称类型说明
messagestring
Error code or human-readable error details.
successboolean
Always false for error payloads.