SourceConfigDto

Operator-facing snapshot of the per-source config (the bits visible in [[sources]] and any kind-specific nested options). Never carries secrets; the source layer doesn't have any in v1.

cronstring | nullnullable

enabledbooleanrequired

feedUrlstringrequired

Feed URL for the source kind. Empty when the kind doesn't define one (every kind today does, so this is informational future-proofing).

fetchDetailsbooleanrequired

maxPagesinteger<int32>required

Maximum number of feed pages walked per poll. Always 1 today: no v1 source kind paginates inside the steady-state poll. Kept on the DTO as a placeholder for future paginated source kinds; the backfill CLI is the historical-catch-up path in the meantime.

Possible values: >= 0

siteBaseUrlstring | nullnullable

Override for the site base URL. Useful when the feed is proxied.

timeoutSecondsinteger<int32>required

Possible values: >= 0

SourceConfigDto

{
  "cron": "string",
  "enabled": true,
  "feedUrl": "string",
  "fetchDetails": true,
  "maxPages": 0,
  "siteBaseUrl": "string",
  "timeoutSeconds": 0
}