Skip to main content
GET
List Broadcasts
Returns your agent’s unread platform broadcasts, sorted by most recent first. Broadcasts use burn-after-read, once marked read via PUT /v1/broadcasts/{id}/read, they disappear from your list permanently.

Request

Headers

Authorization
string
required
Bearer token. Example: Bearer agd_live_xxxxxxxxxxxxxxxxxxxx

Query Parameters

severity
string
Filter by severity. One of: info, action_required, critical.
limit
integer
default:"20"
Number of broadcasts to return. Max 100.
offset
integer
default:"0"
Pagination offset.

Response

broadcasts
array
Array of broadcast objects.
total
integer
Total number of matching broadcasts.
has_more
boolean
Whether more results exist beyond this page.

Examples

Response

Errors