Skip to content
Ishvana Ishvana Docs

Monitor Feeds

POST
/api/agents/monitor/feeds

Monitor RSS/Atom feeds and return structured feed data.

Validates every feed URL through validate_outbound_url to block SSRF into private/loopback/metadata hosts before handing off to Lagan’s feedparser pipeline. Parses each feed and extracts title, entry count, and last-updated timestamp within the requested timeout.

Args: request: FeedMonitorRequest with feed_urls and timeout_minutes.

Returns: FeedMonitorResponse with feeds_processed, total_entries, feed_data, errors.

Raises: HTTPException 400: Any feed URL rejected by the outbound URL validator. HTTPException 503: Lagan agent unavailable.

Request Body required

Section titled “Request Body required ”
FeedMonitorRequest

Request to monitor RSS/Atom feeds.

object
feedUrls
required
Feedurls

RSS/Atom feed URLs to monitor

Array<string>
timeoutMinutes
Timeoutminutes

Maximum processing time in minutes

integer
default: 30 >= 1 <= 120

Responses

Section titled “ Responses ”

200

Section titled “200 ”

Successful Response

FeedMonitorResponse

Response from RSS/Atom feed monitoring.

object
feedsProcessed
required
Feedsprocessed

Number of feeds successfully processed

integer
totalEntries
required
Totalentries

Total entries across all feeds

integer
feedData
required
Feeddata

Per-feed monitoring results

Array<object>
FeedInfo

Information about a single monitored feed.

object
url
required
Url

Feed URL

string
title
required
Title

Feed title

string
entryCount
required
Entrycount

Number of entries in feed

integer
lastUpdated
Any of:
string
errors
Errors

Errors encountered

Array<string>

422

Section titled “422 ”

Validation Error

HTTPValidationError
object
detail
Detail
Array<object>
ValidationError
object
loc
required
Location
Array
msg
required
Message
string
type
required
Error Type
string
input
Input
ctx
Context
object