Agents

Create monitoring agent

Create a new monitoring agent that watches for news about a specific topic or entity. The agent immediately starts matching against existing stories and queues ingestion for fresh content. Be specific in the description for better results.

post/watches

Request

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

Request body

namestring required

Short agent name (e.g., 'AI regulation')

descriptionstring required

What the agent should monitor — be specific for better results

kind'entity' | 'topic'

Agent type (default: topic)

requiredTermsstring[]

Must-include terms — stories must contain at least one of these in title or body. Geographic terms are auto-populated if not provided.

matchQualityThresholdinteger

Minimum match quality score (33-100, default 45). Higher = fewer but more relevant.

languagestring

ISO 639-1 language code (default: en)

Response

Default Response

Changes

No recorded changes to this operation across all 1 revision of this API.