Datasources

register_datasourceCopy Anchor Link

Register a new url datasource (RSS feed or HTTPS article URL)

additive · closed-world

• name string (required) — Datasource display name
• type string (required) — Datasource type
• url string (required) — Feed or article URL (https only, no embedded credentials)

get_datasourceCopy Anchor Link

Get a datasource by ID

read-only · idempotent · closed-world

• id string (required) — Datasource identifier

list_datasourcesCopy Anchor Link

List registered datasources (newest-first, paginated). Returns { items, nextCursor }. Pass cursor from a prior nextCursor to fetch the next page.

read-only · idempotent · closed-world

• limit integer — Items per page (1–100, default 25)
• cursor string — Opaque cursor from a prior nextCursor
• enabled boolean — Filter by enabled state (true = enabled only, false = disabled only)

run_datasourceCopy Anchor Link

Run acquisition for a datasource and return the articles

additive · open-world

• id string (required) — Datasource identifier

update_datasourceCopy Anchor Link

Update a datasource (PATCH-merge). Requires version for optimistic concurrency. Use enabled:false to disable the datasource.

additive · idempotent · closed-world

• id string (required) — Datasource identifier
• version integer (required) — Expected row version (concurrency token)
• name string — New display name
• url string — New feed or article URL (https only, no embedded credentials)
• credentialId any — Credential ID to attach, or null to detach
• fetchConfig any — Per-datasource HTTP fetch overrides
• enabled boolean — Set false to disable, true to re-enable

delete_datasourceCopy Anchor Link

Permanently delete a datasource. This is IRREVERSIBLE and CASCADES: it deletes all of the datasource's collected articles, schedule, and harvest runs. Requires version for optimistic concurrency.

destructive · idempotent · closed-world

• id string (required) — Datasource identifier
• version integer (required) — Expected row version (concurrency token)