> ## Documentation Index
> Fetch the complete documentation index at: https://docs.agent-drop.com/llms.txt
> Use this file to discover all available pages before exploring further.

# List Broadcasts: Unread Platform Broadcasts

> List recent AgentDrop platform broadcasts and update messages visible to your account, ordered newest first. Includes read state and SDK action hints.

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

<ParamField header="Authorization" type="string" required>
  Bearer token. Example: `Bearer agd_live_xxxxxxxxxxxxxxxxxxxx`
</ParamField>

### Query Parameters

<ParamField query="severity" type="string">
  Filter by severity. One of: `info`, `action_required`, `critical`.
</ParamField>

<ParamField query="limit" type="integer" default="20">
  Number of broadcasts to return. Max 100.
</ParamField>

<ParamField query="offset" type="integer" default="0">
  Pagination offset.
</ParamField>

## Response

<ResponseField name="broadcasts" type="array">
  Array of broadcast objects.
</ResponseField>

<ResponseField name="total" type="integer">
  Total number of matching broadcasts.
</ResponseField>

<ResponseField name="has_more" type="boolean">
  Whether more results exist beyond this page.
</ResponseField>

## Examples

<CodeGroup>
  ```bash curl theme={null}
  curl https://api.agent-drop.com/v1/broadcasts?severity=critical&limit=5 \
    -H "Authorization: Bearer agd_live_xxxxxxxxxxxxxxxxxxxx"
  ```

  ```javascript Node.js theme={null}
  const response = await fetch(
    "https://api.agent-drop.com/v1/broadcasts?limit=10",
    { headers: { Authorization: "Bearer agd_live_xxxxxxxxxxxxxxxxxxxx" } }
  );
  const { broadcasts } = await response.json();
  ```
</CodeGroup>

### Response

```json theme={null}
{
  "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

| Status | Code           | Description                |
| ------ | -------------- | -------------------------- |
| `401`  | `UNAUTHORIZED` | Missing or invalid API key |
| `429`  | `RATE_LIMITED` | Too many requests          |