Skip to content

Get Mod Releases

Stable

Getting mod releases returns all publicly visible releases for a specific mod. The Daemon uses this list to display available versions when a user manages an installed mod.

PropertyValue
Applies toWebapp
TriggerClient requests GET /api/mods/:id/releases
PreconditionsNone

Inputs

id : String, required (path parameter). The identifier of the mod.

Assertions

AssertionStatus
The mod must exist and be publicly visibleImplemented

Outputs

{ data: ModReleaseData[] } : Returned with 200 OK when the mod is found. The list contains all public releases for the mod, which may be empty if none have been published.

{ code: 404, error: "NotFoundError" } : Returned when the mod does not exist or is not publicly visible.

Effects

None. This is a read-only operation.

Behavior

mermaid
flowchart TD
    Start([GET /api/mods/:id/releases]) --> Query[modRepository.findPublicModReleases id]

    Query --> Found{Mod found<br/>and public?}
    Found -- No --> NotFound(["404 { code: 404, error: 'NotFoundError' }"])
    Found -- Yes --> Done(["200 { data: ModReleaseData[] }"])

    style NotFound fill:#f87171,color:#fff
    style Done fill:#4ade80,color:#000

See Also

  • Get mod release — Spec page for fetching a single release by identifier.
  • Get latest mod release — Spec page for fetching the most recent release, used by the Daemon when installing.
  • Get mod — Spec page for the parent mod record.