Skip to content
Redot Experimental Documentation

Get versions from file hashes

GET
/version_files

Retrieves versions associated with one or more file hashes. Useful for tracking versions by specific file identifiers.

Parameters

Query Parameters

hashes
required
Array<string>

A list of cryptographic file hashes to fetch the associated versions.

Example
[
  "f50309b2811c10142932bc026ef83f0431bfdbbe612881276d108aba69c4406171c7ba7acd25019fa1b3bfa3c09e20f7382468a098666cdd03f1b7f16d2c214d",
  "abc123def4567890fedcba9876543210abcdef1234567890abcdef9876543210"
]

Responses

200

A list of versions associated with the provided file hashes.

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

No versions found for the provided hashes.