list_broadcast_audiences
Every audience segment a broadcast accepts for a project, with its traits and a recipient estimate. Read-only.
List the segments broadcast_message accepts for a project, the catalogue
GET /v1/projects/{project}/broadcasts/audiences returns: each segment's value and
label, what it means, whether it requires a pass window, whether it can be narrowed to a
plan, whether it reads the expiring-within-days horizon, and a recipient_estimate at the
default horizon — null for the segments that need a pass window named first. Call it before
composing a broadcast so the segment word and its filters are real rather than guessed;
preview_broadcast_audience then sizes one segment with your exact filters.
Read-only. Never mutates anything.
Requires ability
The token behind the MCP session must hold it, or the call is refused with TOKEN_MISSING_ABILITY.
Runs the same action as
The REST endpoint and this tool share one action, so validation, permissions and events are identical.
Annotations
It reads and never changes anything.
Arguments
project_id*stringUUID of the project the broadcast would go to.
How it fails
RESOURCE_NOT_FOUNDthe project is unknown or outside the token's scope.
TOKEN_MISSING_ABILITYtoken lacks broadcast:send.
Arguments
project_id(required) — UUID of the project the broadcast would go to.
How is this guide?
Last updated on