Stream Music Schedule
Create music schedule slot
POST
https://api.tunio.ai/ v1/ stream-music-schedule/ slotAdds 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
| Name | Type | Description |
|---|---|---|
| duration_minRequired | integer | Slot length in minutes, at least 1. The slot must end before midnight in the stream's timezone. |
| force | boolean | When the slot overlaps existing music slots of that day, true deletes every overlapping slot and
adds this one; false (default) answers 409. |
| playlist_idRequired | string | UUID of a playlist owned by the caller. |
| start_atRequired | string (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_idRequired | string | UUID of the stream. |
| volume | number | 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": 108}
Responses
| Name | Type | Description |
|---|---|---|
| slot_id | string | UUID of the created slot. |
| success | boolean | Always true on success. |
| 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 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 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. |