Announcements

List announcement backgrounds

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

List 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

NameTypeDescription
titlestringTitle filter (substring, case-insensitive)
tts_durationstringSpeech length in seconds the background must cover
pagestringPage number
per_pagestringItems per page (max 100)

Responses

NameTypeDescription
itemsarray
Items contains backgrounds, newest first.
[item]Requiredobject
-
paginationobject
-
pageinteger
Page is the current page index starting from 1.
per_pageinteger
PerPage is the requested page size.
totalinteger
Total is overall number of matching records.
successboolean
-
NameTypeDescription
messagestring
Message contains human readable error details.
successboolean
Success is always false for error payloads.
NameTypeDescription
messagestring
Message contains human readable error details.
successboolean
Success is always false for error payloads.