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_durationintegerSpeech length in seconds the background must cover
pageintegerPage number
per_pageintegerItems per page (max 100)

Responses

NameTypeDescription
itemsarray
Items contains backgrounds, newest first.
[item]Requiredobject
-
paginationobject
-
pageinteger
Current page, starting from 1.
per_pageinteger
Page size actually applied (1..100).
totalinteger
Total number of matching records.
successboolean
-
NameTypeDescription
messagestring
Error code or human-readable error details.
successboolean
Always false for error payloads.
NameTypeDescription
messagestring
Error code or human-readable error details.
successboolean
Always false for error payloads.