Skip to main content

ReleaseLedgerEntryDto

A single release announcement. Sources write these; the inbox reads them.

chapternumber,null<double>nullable

Decimal supports 12.5 etc.

confidencenumber<double>required
createdAtstring<date-time>required
externalReleaseIdstringrequired

Plugin-stable identity for the release (used for dedup).

Example: nyaa:1234567
formatHints

Sparse { "jxl": true, "container": "cbz", ... }.

groupOrUploaderstring | nullnullable

Group/scanlator/uploader attribution.

idstring<uuid>required
Example: 550e8400-e29b-41d4-a716-446655440a00
infoHashstring | nullnullable

Torrent info_hash, if applicable.

languagestring | nullnullable
mediaUrlstring | nullnullable

Optional second URL for direct fetch (.torrent, magnet:, DDL link). Travels paired with [Self::media_url_kind].

mediaUrlKindstring | nullnullable

Classifies what media_url points at: torrent | magnet | direct | other. The frontend uses this to pick a kind-specific icon next to the standard external-link icon.

metadata

Source-specific extras (free-form).

observedAtstring<date-time>required
payloadUrlstringrequired

Where to acquire the release. Conventionally a human-readable landing page (Nyaa view page, MangaUpdates release page).

seriesIdstring<uuid>required
Example: 550e8400-e29b-41d4-a716-446655440002
seriesTitlestringrequired

Series title at the time of the response. Joined from the series table so the inbox UI can render a human-readable label without a follow-up fetch. Falls back to the empty string only if the series row was hard-deleted between the join and the read.

Example: Chainsaw Man
sourceIdstring<uuid>required
Example: 550e8400-e29b-41d4-a716-446655440b00
statestringrequired

announced | dismissed | marked_acquired | hidden.

volumeinteger,null<int32>nullable
ReleaseLedgerEntryDto
{
  "chapter": 0,
  "confidence": 0,
  "createdAt": "2024-07-29T15:51:28.071Z",
  "externalReleaseId": "nyaa:1234567",
  "groupOrUploader": "string",
  "id": "550e8400-e29b-41d4-a716-446655440a00",
  "infoHash": "string",
  "language": "string",
  "mediaUrl": "string",
  "mediaUrlKind": "string",
  "observedAt": "2024-07-29T15:51:28.071Z",
  "payloadUrl": "string",
  "seriesId": "550e8400-e29b-41d4-a716-446655440002",
  "seriesTitle": "Chainsaw Man",
  "sourceId": "550e8400-e29b-41d4-a716-446655440b00",
  "state": "string",
  "volume": 0
}