Announcements
Create a new announcement
POST
https://api.tunio.ai/v1/announcementsCreate a new announcement for a stream
Request body
Announcement data
| Name | Type | Description |
|---|---|---|
| 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. |
| modelRequired | string | Model is the UUID of the TTS model used for generation. |
| 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. |
Request example
01{02 "end_date": "2024-12-31T23:59:59Z",03 "has_audio_warning": false,04 "message": "Today's weather will be sunny with temperatures reaching 25°C",05 "model": "123e4567-e89b-12d3-a456-426614174000",06 "speed": 1,07 "start_date": "2024-01-15T14:30:00Z",08 "title": "Daily Weather Update"09}
Responses
| Name | Type | Description |
|---|---|---|
| success | boolean | Success signals the create finished successfully. |
| uuid | string | UUID is the created announcement identifier. |
| 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. |