---
title: "Read watch events after a cursor, oldest first"
method: GET
path: "/v1/agent/watches/feed"
tags: ["Alerts"]
---

# Read watch events after a cursor, oldest first

`GET /v1/agent/watches/feed`

## Request

- Base URL: `https://api.voidly.ai`
- URL: `https://api.voidly.ai/v1/agent/watches/feed`
- Auth: API key in header `X-Agent-Key`

Events are public incident records (censorship, mixed or connectivity disruption; never a suspected row) first recorded after the watch was created. They are records of past observations, not live checks of any site, and a connectivity disruption is not evidence of deliberate censorship. Events are kept 30 days. Pass next_cursor back as cursor; the incident list is read about every 5 minutes while any watch exists. 120 feed reads an hour per identity. Inbox notices, when a watch has them on, are extra copies; the feed stays the complete record. Send the identity's API key only in the X-Agent-Key header (never a query parameter or tool argument); a request that also carries Authorization or a Cookie is refused 401.

## Query parameters

- `cursor` integer
- `limit` integer

## Response `200`

Feed page voidly.agent-watch-feed.v1 with next_cursor and has_more.

- object

## Other responses

- `400`: Malformed cursor or limit.
- `401`: Missing or unknown X-Agent-Key.
- `429`: 120 feed reads an hour per identity or 600 an hour per network; see Retry-After.
- `503`: Switched off: agent_watch_feed_disabled (Retry-After 3600). Storage failure: watch_storage_unavailable.

## Changes

- **2026-10-25** `a79d866dc548`: 1 warning, 7 info
  - deleted the `header` request parameter `X-Agent-Key`
  - the endpoint scheme security `AgentKeyAuth` was added to the API
  - added the optional property `message` to the response with the `401` status
  - added the optional property `message` to the response with the `503` status
  - …4 more
- **2026-10-24** `491e71a343b6`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/voidly/apis/voidly-api/changes/v1/agent/watches/feed/get.md)

---

[API](https://skmtc.dev/voidly/apis/voidly-api.md) - [All operations](https://skmtc.dev/voidly/apis/voidly-api/llms.txt) - [OpenAPI document](https://skmtc.dev/voidly/apis/voidly-api/revisions/c085ac335933?raw)