Skip to main content

UnresolvedRelease

commentSuggestedLinks object
oneOf
null
ddlUrlstring | nullnullable
descriptionHtmlstring | nullnullable

Raw description blob (markdown for Nyaa posts that ran detail fetch; the RSS anchor stub otherwise). Omitted when absent. Surfaced so the review and kept views can render it inline without opening the post.

externalIdstringrequired
extractedLinks object
oneOf
null
filesstring[]required
formatsstring[]required
idstringrequired
infoHashstring | nullnullable
informationUrlstring | nullnullable

URL from the post's "Information" field, verbatim. Surfaced even when it is not a provider link we resolve against (a publisher page, a Discord invite, …) so the review and kept views show the uploader's cited source. Omitted when absent.

lastResolveAttemptAtinteger,null<int64>nullable
linkstringrequired
magnetstring | nullnullable
observedAtinteger<int64>required
postedAtinteger<int64>required
resolutionAttemptsinteger<int32>required
resolutionConfidencenumber,null<double>nullable
resolutionPathstring | nullnullable
resolutionStatusstringrequired
sentToClientAtinteger,null<int64>nullable

Epoch seconds the release was pushed to the torrent client, or omitted if it was never sent. Drives the "Sent" badge on the review/kept cards.

sentToClientLabelstring | nullnullable

Label the release was sent to the torrent client with. Omitted when absent (never sent, or sent without a label).

seriesIdinteger,null<int32>nullable
sizeBytesinteger,null<int64>nullable
sourceKindstringrequired
sourceNamestringrequired
titlestringrequired
torrentUrlstring | nullnullable
candidates object[]required
  • Array [
    • alternateTitlesstring[]required

    Alternate / native titles persisted on the series row. Surfaced in the review UI so romaji / Japanese / publisher variants are visible without opening the provider page.

    externalIdstring | nullnullable
    kindstring | nullnullable

    Series format (manga / novel / manhwa / …) from provider metadata. Surfaced so the operator can sanity-check a candidate's format against the release before linking. None when the provider did not classify the series.

    providerstring | nullnullable

    Provider + external_id pair for building a link to the provider's page. Prefers the active provider's mapping; falls back to any other mapping so the operator always has a way to inspect the candidate. None when the series has no external IDs persisted.

    reasonstring | nullnullable
    scorenumber<double>required
    seriesCoverUrlstring | nullnullable
    seriesIdinteger<int32>required
    seriesTitlestringrequired
    totalChaptersinteger,null<int32>nullable
    totalVolumesinteger,null<int32>nullable

    Published volume/chapter counts from provider metadata. Let the operator compare the release's contents (see the torrent file list) against the candidate series' length. None when the provider did not expose them or the series predates this field.

  • ]
    • cleanupRulesAppliedstring[]required

    Stable rule names that fired during cleanup (e.g. strip_parens, split_alternates). Rendered as badge chips on the review card.

    searchQueriesstring[]required

    Search queries the title cleaner produced for this release (longest-first). Empty when the release predates the cleaner or failed to persist; the next resolve cycle backfills.

    topCandidate object
    oneOf
    null
    UnresolvedRelease
    {
      "commentSuggestedLinks": "null",
      "ddlUrl": "string",
      "descriptionHtml": "string",
      "externalId": "string",
      "extractedLinks": "null",
      "files": [
        "string"
      ],
      "formats": [
        "string"
      ],
      "id": "string",
      "infoHash": "string",
      "informationUrl": "string",
      "lastResolveAttemptAt": 0,
      "link": "string",
      "magnet": "string",
      "observedAt": 0,
      "postedAt": 0,
      "resolutionAttempts": 0,
      "resolutionConfidence": 0,
      "resolutionPath": "string",
      "resolutionStatus": "string",
      "sentToClientAt": 0,
      "sentToClientLabel": "string",
      "seriesId": 0,
      "sizeBytes": 0,
      "sourceKind": "string",
      "sourceName": "string",
      "title": "string",
      "torrentUrl": "string",
      "candidates": [
        {
          "alternateTitles": [
            "string"
          ],
          "externalId": "string",
          "kind": "string",
          "provider": "string",
          "reason": "string",
          "score": 0,
          "seriesCoverUrl": "string",
          "seriesId": 0,
          "seriesTitle": "string",
          "totalChapters": 0,
          "totalVolumes": 0
        }
      ],
      "cleanupRulesApplied": [
        "string"
      ],
      "searchQueries": [
        "string"
      ],
      "topCandidate": "null"
    }