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.
| Property | Value |
|---|---|
| Applies to | Webapp |
| Trigger | Client requests GET /api/mods/:id/releases |
| Preconditions | None |
Inputs
id : String, required (path parameter). The identifier of the mod.
Assertions
| Assertion | Status |
|---|---|
| The mod must exist and be publicly visible | Implemented |
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:#000See 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.