Announcements
Update an announcement
PUT
https://api.tunio.ai/v1/announcements/{announcement_id}Update an existing announcement by UUID
Path parameters
| Name | Type | Description |
|---|---|---|
| announcement_idRequired | string | Announcement ID |
Request body
Updated announcement data
| Name | Type | Description |
|---|---|---|
| background_uuid | string | BackgroundUUID updates background track. |
| background_volume | number | BackgroundVolume updates background volume (0..1). |
| end_date | string | EndDate adjusts when the announcement expires. |
| has_audio_warning | boolean | HasAudioWarning toggles start warning tone. |
| message | string | Message updates the body text or script (max 500 characters). |
| model_id | string | Model updates the TTS model UUID. |
| speed | number | Speed optionally customizes playback speed multiplier. |
| start_date | string | StartDate adjusts when the announcement becomes active. |
| title | string | Title allows updating the announcement headline (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": true,06 "message": "Updated weather message",07 "model_id": "123e4567-e89b-12d3-a456-426614174000",08 "speed": 1,09 "start_date": "2024-01-15T14:30:00Z",10 "title": "Updated Weather Update"11}
Responses
| Name | Type | Description |
|---|---|---|
| success | boolean | Success indicates the request completed without errors. |
| 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. |