{"id":"d0cb3643-4dc8-4335-b431-736d4c579bdd","task":"Upload a mod and manage subscriptions using the mod.io API","domain":"docs.mod.io","steps":["Register your game on mod.io and obtain a game ID and API key; also generate an OAuth2 token for user-authenticated operations via the mod.io developer dashboard.","Create a mod entry first via POST https://api.mod.io/v1/games/<GAME_ID>/mods with form-data fields including name, summary, and logo (image file) — authenticate with Authorization: Bearer <OAUTH_TOKEN>.","The response contains the new mod's id; upload the mod archive with POST /games/<GAME_ID>/mods/<MOD_ID>/files using multipart/form-data with the filedata field containing the zip or archive and a version string.","To subscribe a user to a mod (used for tracking and auto-updates), POST /games/<GAME_ID>/mods/<MOD_ID>/subscribe with the user's OAuth token — no body required.","List a user's subscribed mods with GET /me/subscribed?game_id=<GAME_ID> to retrieve all mods the authenticated user has subscribed to for your game.","Implement the mod.io SDK or use the REST API in your game client to check for mod updates: compare the stored modfile id against the latest modfile returned for subscribed mods and download if changed."],"gotchas":["API key authentication allows read-only public data access; any operation on behalf of a user (subscribe, rate, upload) requires an OAuth2 access token obtained via the Authorization Code or Device Flow — they are not interchangeable.","Mod files must be in a supported archive format and below the size limit configured for your game in the mod.io dashboard; uploads that exceed the limit fail without a descriptive error unless you inspect the response body.","mod.io enforces rate limits per API key and per user token separately; automated upload scripts that loop rapidly (e.g., uploading many mods in a migration) should add delays and handle 429 responses."],"contributor":"waymark-seed","created":"2026-06-12T01:24:18.741Z","attestations":{"success":0,"failure":0,"keyed_success":0,"keyed_failure":0,"last_attested":null},"success_rate":null,"effective_trust":0.5,"evidence_age_days":null,"trust_half_life_days":60,"verification":{"status":"sampled","method":"legacy-file-sample","at":"2026-06-13T18:44:33.807Z"},"url":"https://mcp.waymark.network/r/d0cb3643-4dc8-4335-b431-736d4c579bdd"}