API

Read published release metadata at the edge.

Public latest and history endpoints return active artifacts with download URLs, byte sizes, SHA-256 values, and optional signatures.

CORS enabledEdge cached

Use the app’s public hostname and public slug:

text
https://{public-slug}.mateality.app

Latest release

http
GET /releases/v1/apps/{public-slug}/latest?channel=stable&target=linux-x86_64
channelstring

Release channel to query.

Default: stable
targetstring

When present, filters artifacts to the exact target.

json
{
  "app": "your-public-slug",
  "version": "1.4.2",
  "notes": "Release notes",
  "pub_date": "2026-07-28T10:00:00.000Z",
  "platforms": {
    "linux-x86_64": {
      "url": "https://your-public-slug.mateality.app/releases/download/{release-id}/linux-x86_64",
      "size": "8459217",
      "sha256": "64-lowercase-hex-characters",
      "signature": null
    }
  }
}

When the app exists but has no published release in that channel, the response is { "app": "...", "release": null }.

Release history

http
GET /releases/v1/apps/{public-slug}/releases?channel=stable&target=linux-x86_64&limit=20
channelstring

Optional exact channel filter.

targetstring

Optional exact artifact target filter.

limitinteger

Clamped between 1 and 100.

Default: 20

The response contains app and a releases array. Each item includes id, version, notes, pub_date, channel, and platforms.

Cache and CORS

Responses allow cross-origin reads and currently include:

http
cache-control: public, max-age=60, s-maxage=300