Announcements
List announcement backgrounds
GET
https://api.tunio.ai/ v1/ announcements/ backgroundsList the music beds an announcement can be mixed over. Pass background_id as background_uuid when creating or updating an announcement. With tts_duration, only backgrounds long enough for speech of that many seconds (plus the announcement padding) are returned.
Query parameters
| Name | Type | Description |
|---|---|---|
| title | string | Title filter (substring, case-insensitive) |
| tts_duration | integer | Speech length in seconds the background must cover |
| page | integer | Page number |
| per_page | integer | Items per page (max 100) |
Responses
| Name | Type | Description |
|---|---|---|
| items | array | Items contains backgrounds, newest first. |
| [item]Required | object | - |
| pagination | object | - |
| page | integer | Current page, starting from 1. |
| per_page | integer | Page size actually applied (1..100). |
| total | integer | Total number of matching records. |
| success | boolean | - |
| 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. |