Get multiple versions by their IDs

GET

/versions

Fetch multiple versions of the engine by their IDs.

Parameters

Query Parameters

ids

required

Array<string>

[
  "uohlw2d5lfh5pdgaavtsw9v6",
  "a2df73h5g8i7j1kl4m5np9p2"
]

List of version IDs to fetch

Responses

200

A list of versions matching the provided IDs

Array<object>

object

name

Name of the version

string

Version 1.0.0

version_number

The version number. Ideally will follow semantic versioning

string

1.0.0

changelog

The changelog for this version

string

nullable

List of changes in this version...

changelog_url

A direct URL to the changelog for this version

string

nullable

https://example.com/changelog

version_type

The release channel for this version

string

Allowed values: release beta alpha

release

status

The current status of the version

string

Allowed values: listed archived draft unlisted scheduled unknown

listed

required

Unique identifier for the version (cuid2)

string

uohlw2d5lfh5pdgaavtsw9v6

author_id

required

The ID of the author who published this version (cuid2)

string

dtgc58bc5olg7wlvhb10xpy6

date_published

required

The date this version was published, in ISO 8601 format

string

2024-11-15T10:00:00Z

files

required

A list of files available for download for this version

Array<object>

object

hashes

required

A map of hashes of the file. The key is the hashing algorithm and the value is the string version of the hash

object

key

additional properties

string

{
  "sha256": "abc123def456...",
  "md5": "d41d8cd98f00b204e9800998ecf8427e"
}

url

required

A direct link to the file

string

https://example.com/my_file.exe

filename

required

The name of the file

string

my_file.exe

size

required

The size of the file in bytes

integer

platform

required

The platform for which the file is intended

string

windows

400

Invalid query parameters

404

One or more versions not found