---
title: "List monitoring agents"
method: GET
path: "/watches"
tags: ["Agents"]
---

# List monitoring agents

`GET /watches`

## Request

- Base URL: `https://api.agentic-news.ai`
- URL: `https://api.agentic-news.ai/watches`
- Auth: HTTP bearer

List all monitoring agents (watches) for the authenticated user. Each agent continuously monitors a topic and surfaces matching stories in your briefing.

## Response `200`

Default Response

- object
  - `watches` object[]
    - `id` string
    - `name` string
    - `description` string
    - `kind` 'entity' | 'topic'
    - `matchQualityThreshold` integer: Minimum match quality (33-100)
    - `requiredTerms` string[]: Must-include terms
    - `termsUnmatchable` boolean: True when the required terms cannot match ANY article — this agent can never surface a story until they change
    - `lensId` string, nullable: Assigned lens ID
    - `lensName` string, nullable: Assigned lens name
    - `paused` boolean
    - `createdAt` string, date-time
  - `count` number

## Other responses

- `401`: Default Response
- `500`: Default Response

---

[API](https://skmtc.dev/agentic-news/apis/agentic-news-api.md) · [All operations](https://skmtc.dev/agentic-news/apis/agentic-news-api/llms.txt) · [OpenAPI document](https://skmtc.dev/agentic-news/apis/agentic-news-api/revisions/02fe31decff9?raw)