Skip to content
Redot Experimental Documentation

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
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
id

A unique identifier for this version, using the CUID2 format

string
uohlw2d5lfh5pdgaavtsw9v6
author_id

The unique identifier of the author who published this version, formatted as CUID2

string
dtgc58bc5olg7wlvhb10xpy6
date_published

The date this version was published, in ISO 8601 format

string
2024-11-15T10:00:00Z
files
Array<object>

A list of files available for download for this version

object
hash

Hash (e.g., SHA-512) for verifying file integrity

string
abc123def456...
url

A direct link to the file

string
https://example.com/my_file.exe
filename

The name of the file

string
my_file.exe
size

The size of the file in bytes

integer
1234567
architecture

Architecture for the file (e.g., x86, x64, arm64)

string
x64
github_release_url

URL to the GitHub release

string
https://github.com/username/repo/releases/tag/example

400

Invalid query parameters

object
error
required

A brief description of the error related to invalid query parameters.

string
Invalid query parameters
description
required

A more detailed explanation of what was wrong with the query parameters.

string

404

One or more versions not found