Announcements

Create a new announcement

POST

https://api.tunio.ai/v1/announcements

Create a new announcement for a stream

Request body

Announcement data

Name	Type	Description
background_uuid	string	BackgroundUUID optionally links a background track.
background_volume	number	BackgroundVolume defines background volume (0..1).
end_date	string	EndDate limits the latest playback date.
has_audio_warning	boolean	HasAudioWarning toggles an audible warning tone before playback.
messageRequired	string	Message contains the announcement text or TTS script (max 500 characters).
model_id	string	Model is the UUID of the TTS model used for generation. If omitted, a default is used.
speed	number	Speed optionally customizes playback speed multiplier.
start_date	string	StartDate limits the earliest playback date.
titleRequired	string	Title is the displayed announcement header (max 500 characters).

Request example

01{
02  "background_uuid": "123e4567-e89b-12d3-a456-426614174001",
03  "background_volume": 0.3,
04  "end_date": "2024-12-31T23:59:59Z",
05  "has_audio_warning": false,
06  "message": "Today's weather will be sunny with temperatures reaching 25°C",
07  "model_id": "123e4567-e89b-12d3-a456-426614174000",
08  "speed": 1,
09  "start_date": "2024-01-15T14:30:00Z",
10  "title": "Daily Weather Update"
11}

Responses

Name	Type	Description
announcement_id	string	UUID is the created announcement identifier.
success	boolean	Success signals the create finished successfully.

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.