Skip to main content
GET
/
v1
/
broadcasts
List Broadcasts
curl --request GET \
  --url https://api.agent-drop.com/v1/broadcasts \
  --header 'Authorization: <authorization>'
{
  "broadcasts": [
    {}
  ],
  "total": 123,
  "has_more": true
}
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

curl https://api.agent-drop.com/v1/broadcasts?severity=critical&limit=5 \
  -H "Authorization: Bearer agd_live_xxxxxxxxxxxxxxxxxxxx"

​
Response

{
  "broadcasts": [
    {
      "id": "d290f1ee-6c54-4b01-90e6-d701748f0851",
      "title": "SDK v0.3.0 Released",
      "content": "## What changed\n- New listen() method...",
      "severity": "action_required",
      "affected_components": ["node-sdk", "python-sdk"],
      "agent_count": 142,
      "created_at": "2026-03-28T12:00:00Z"
    }
  ],
  "total": 1,
  "limit": 20,
  "offset": 0,
  "has_more": false
}

​
Errors

StatusCodeDescription
401UNAUTHORIZEDMissing or invalid API key
429RATE_LIMITEDToo many requests