ReleaseSourceDto

A configured release source (one row per logical feed).

config

Source-specific configuration (free-form).

createdAtstring<date-time>required

cronSchedulestring | nullnullable

Per-source cron override (5-field POSIX cron). null when the row inherits the server-wide release_tracking.default_cron_schedule. Always present in the response (not omitted on null) so clients can distinguish "inheriting" from "field missing."

displayNamestringrequired

effectiveCronSchedulestringrequired

The cron expression actually used by the scheduler for this source: the row's cron_schedule if set, otherwise the resolved server-wide default. Lets the UI display "Daily (Default)" without needing to fetch the global setting separately.

enabledbooleanrequired

etagstring | nullnullable

Opaque etag/cursor used for conditional fetches.

idstring<uuid>required

Example: 550e8400-e29b-41d4-a716-446655440b00

kindstringrequired

rss-uploader | rss-series | api-feed | metadata-feed | metadata-piggyback.

lastErrorstring | nullnullable

lastErrorAtstring,null<date-time>nullable

lastPolledAtstring,null<date-time>nullable

lastSummarystring | nullnullable

One-line summary of the most recent successful poll. Surfaced under the row's status badge so users can see why a poll returned no announcements without grepping logs. NULL until the first successful poll on the source.

pluginIdstringrequired

Owning plugin id, or core for in-core synthetic sources.

Example: release-nyaa

sourceKeystringrequired

Plugin-defined unique key.

Example: nyaa:user:tsuna69

updatedAtstring<date-time>required

ReleaseSourceDto
{
  "createdAt": "2024-07-29T15:51:28.071Z",
  "cronSchedule": "string",
  "displayName": "string",
  "effectiveCronSchedule": "string",
  "enabled": true,
  "etag": "string",
  "id": "550e8400-e29b-41d4-a716-446655440b00",
  "kind": "string",
  "lastError": "string",
  "lastErrorAt": "2024-07-29T15:51:28.071Z",
  "lastPolledAt": "2024-07-29T15:51:28.071Z",
  "lastSummary": "string",
  "pluginId": "release-nyaa",
  "sourceKey": "nyaa:user:tsuna69",
  "updatedAt": "2024-07-29T15:51:28.071Z"
}