Skip to main content

LibraryJobDto

Library job row exposed via GET / list / response.

config objectrequired

Type-discriminated job config exposed over the wire.

Phase 9 only ships the metadata_refresh variant; future job types extend the enum.

oneOf
bookExtraFieldsstring[]

Reserved for the book-scope future work.

bookFieldGroupsstring[]

Reserved for the book-scope future work.

existingSourceIdsOnlyboolean

When true, the planner skips series with no stored external ID.

extraFieldsstring[]

Series-side individual field overrides (camelCase).

fieldGroupsstring[]

Series-side field groups (snake_case identifiers).

maxConcurrencyinteger<int32>

Per-task fan-out; clamped at run time.

Possible values: >= 0

providerstringrequired

Plugin reference, e.g. "plugin:mangabaka".

scopeRefreshScope (string)

Refresh scope. Phase 9 only honours series_only at runtime.

Possible values: [series_only, books_only, series_and_books]

skipRecentlySyncedWithinSinteger<int32>

Skip series whose last_synced_at is younger than this many seconds.

Possible values: >= 0

typestringrequired

Possible values: [metadata_refresh]

createdAtstring<date-time>required
cronSchedulestringrequired
enabledbooleanrequired
idstring<uuid>required
lastRunAtstring,null<date-time>nullable
lastRunMessagestring | nullnullable
lastRunStatusstring | nullnullable
libraryIdstring<uuid>required
namestringrequired
timezonestring | nullnullable
updatedAtstring<date-time>required
LibraryJobDto
{
  "config": {
    "bookExtraFields": [
      "string"
    ],
    "bookFieldGroups": [
      "string"
    ],
    "existingSourceIdsOnly": true,
    "extraFields": [
      "string"
    ],
    "fieldGroups": [
      "string"
    ],
    "maxConcurrency": 0,
    "provider": "string",
    "scope": "series_only",
    "skipRecentlySyncedWithinS": 0,
    "type": "metadata_refresh"
  },
  "createdAt": "2024-07-29T15:51:28.071Z",
  "cronSchedule": "string",
  "enabled": true,
  "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "lastRunAt": "2024-07-29T15:51:28.071Z",
  "lastRunMessage": "string",
  "lastRunStatus": "string",
  "libraryId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "name": "string",
  "timezone": "string",
  "updatedAt": "2024-07-29T15:51:28.071Z"
}