Register Mod Release Download

Stable

Registering a mod release download records that a Daemon instance has installed a specific release. The Daemon calls this endpoint immediately after a successful installation to increment the release's download count.

Property	Value
Applies to	Webapp
Trigger	Daemon calls `POST /api/mods/:id/releases/:releaseId/downloads` after installing a release
Preconditions	None — no authentication required

Inputs

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

releaseId : String, required (path parameter). The identifier of the release.

daemonInstanceId : String, required (request body). The unique identifier of the Daemon instance that performed the installation.

Assertions

Assertion	Status
The release must exist and be publicly visible in the registry	Implemented

Outputs

{ ok: true } : Returned when the release is found and the download is recorded.

{ code: 404, error: "ReleaseNotFoundError" } : Returned when the release does not exist or is not public. No download is recorded.

Note: The current implementation returns HTTP 200 for this error case due to a missing status code argument in the handler. The spec documents the intended behavior; see the implementation for the actual response code.

Effects

Effect	Status
A download record is written to the downloads store for the `(modId, releaseId, daemonInstanceId)` triple	Implemented

Behavior

mermaid

flowchart TD
    Start(["POST /api/mods/:id/releases/:releaseId/downloads"]) --> FindRelease[findPublicModReleaseById id releaseId]

    FindRelease --> Found{Release found<br/>and public?}

    Found -- No --> NotFound(["{ code: 404, error: 'ReleaseNotFoundError' }<br/>⚠️ currently returns HTTP 200"])
    Found -- Yes --> Register[registerModReleaseDownload modId releaseId daemonInstanceId]

    Register --> Done(["200 { ok: true }"])

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

Register Mod Release Download ​

Inputs ​

Assertions ​

Outputs ​

Effects ​

Behavior ​