Sign in

v19

latestOpenAPI 3.0.0raw.githubusercontent.com2026-08-037759134.1 KB
versions

Create a version

This route creates a version on an existing project. There must be at least one file attached to each new version, unless the new version's status is draft. .mrpack, .jar, .zip, and .litemod files are accepted.

The request is a multipart request with at least two form fields: one is data, which includes a JSON body with the version metadata as shown below, and at least one field containing an upload file.

You can name the file parts anything you would like, but you must list each of the parts' names in file_parts, and optionally, provide one to use as the primary file in primary_file.

post/version

Response

Expected response to a valid request

namestring required

The name of this version

version_numberstring required

The version number. Ideally will follow semantic versioning

changelogstring nullable

The changelog for this version

game_versionsstring[] required

A list of versions of Minecraft that this version supports

version_type'release' | 'beta' | 'alpha' required

The release channel for this version

loadersstring[] required

The mod loaders that this version supports. In case of resource packs, use "minecraft"

featuredboolean required

Whether the version is featured or not

status'listed' | 'archived' | 'draft' | 'unlisted' | 'scheduled' | 'unknown'
requested_status'listed' | 'archived' | 'draft' | 'unlisted' nullable
idstring required

The ID of the version, encoded as a base62 string

project_idstring required

The ID of the project this version is for

author_idstring required

The ID of the author who published this version

date_publishedstring ISO-8601 required
downloadsinteger required

The number of times this version has been downloaded

changelog_urlstring nullable

A link to the changelog for this version. Always null, only kept for legacy compatibility.

Example response

{
  "name": "Version 1.0.0",
  "version_number": "1.0.0",
  "changelog": "List of changes in this version: ...",
  "dependencies": [
    {
      "version_id": "IIJJKKLL",
      "project_id": "QQRRSSTT",
      "file_name": "sodium-fabric-mc1.19-0.4.2+build.16.jar",
      "dependency_type": "required"
    }
  ],
  "game_versions": [
    "1.16.5",
    "1.17.1"
  ],
  "version_type": "release",
  "loaders": [
    "fabric",
    "forge",
    "minecraft"
  ],
  "featured": true,
  "status": "listed",
  "id": "IIJJKKLL",
  "project_id": "AABBCCDD",
  "author_id": "EEFFGGHH",
  "files": [
    {
      "hashes": {
        "sha512": "93ecf5fe02914fb53d94aa3d28c1fb562e23985f8e4d48b9038422798618761fe208a31ca9b723667a4e05de0d91a3f86bcd8d018f6a686c39550e21b198d96f",
        "sha1": "c84dd4b3580c02b79958a0590afd5783d80ef504"
      },
      "url": "https://cdn.modrinth.com/data/AABBCCDD/versions/1.0.0/my_file.jar",
      "filename": "my_file.jar",
      "size": 1097270,
      "file_type": "required-resource-pack"
    }
  ]
}