Stream

Set music override

POST

https://api.tunio.ai/v1/stream/{stream_id}/override

Overrides the current music selection with an ad-hoc dynamic filter spec (genres, BPM range, languages, instrumental, music source, collection) for an optional TTL in minutes (clamped to 10..1440, default 60). It supersedes the base music schedule until it expires or is cleared; announcements and jingles keep running. Any subset of filters may be set, but at least one is required. A manual override wins over automated (POS) ones.

Path parameters

Name	Type	Description
stream_idRequired	string	Stream ID

Request body

Music override request

Name	Type	Description
bpm_from	integer	-
bpm_to	integer	-
collection_uuid	string	-
genres	array	-
[item]Required	string	-
is_instrumental	boolean	-
languages	array	-
[item]Required	string	-
music_type	string	-
ttl_minutes	integer	-

Request example

01{
02  "bpm_from": 0,
03  "bpm_to": 0,
04  "collection_uuid": "string",
05  "genres": [
06    "string"
07  ],
08  "is_instrumental": true,
09  "languages": [
10    "string"
11  ],
12  "music_type": "string",
13  "ttl_minutes": 0
14}

Responses

No schema details were provided for this payload.

Name	Type	Description
message	string	Message contains human readable error details.
success	boolean	Success is always false for error payloads.

Name	Type	Description
message	string	Message contains human readable error details.
success	boolean	Success is always false for error payloads.

Name	Type	Description
message	string	Message contains human readable error details.
success	boolean	Success is always false for error payloads.

Name	Type	Description
message	string	Message contains human readable error details.
success	boolean	Success is always false for error payloads.

Name	Type	Description
message	string	Message contains human readable error details.
success	boolean	Success is always false for error payloads.

Name	Type	Description
message	string	Message contains human readable error details.
success	boolean	Success is always false for error payloads.