Skip to content
Redot Experimental Documentation

Get a list of all versions

GET
/version

Fetch all available versions of the engine with sorting and pagination.

Parameters

Query Parameters

version_type
string
Allowed values: release beta alpha 
release

Optionally filter by version type (e.g., release, beta, alpha). Defaults to “release”.

index
string
default: newest
Allowed values: relevance downloads newest updated 
newest

Sort the list of versions by a specific criterion.

offset
integer
20

The offset for pagination, specifying how many items to skip.

limit
integer
default: 10 <= 100 
20

The number of versions to return, with a maximum limit.

Responses

200

A list of versions

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