Releases Index
Latest releases
View .md

Latest releases (cross-source feed)

GET
/releases/latest

Cacheable cross-source feed ordered by (publishedAt DESC, fetchedAt DESC, id DESC). ?source= and ?org= are mutually exclusive scopes. ?exclude= strips releases by source type — comma-separated values from github,scrape,feed,agent. By default, coverage-side rows (releases that roll up into a canonical release) are hidden; pass ?include_coverage=true to include them. Prereleases (canaries / alphas / betas / RCs) are also hidden by default — pass ?include_prereleases=true to surface them, matching the source-feed and MCP defaults. The unfiltered homepage shape is served through KV (X-Cache: HIT|MISS); filtered requests bypass cache (X-Cache: BYPASS).

Authorization

bearerAuth
headerAuthorizationBearer <relk_… | relu_… | OAuth JWT>

Machine/operator tokens use the relk_ prefix; self-serve read-only user keys use relu_; Sign in with Releases supplies an OAuth access token. Required scope depends on the endpoint.

Query Parameters

count?integer

Number of releases to return. Clamped to [1, 100].

Range1 <= value <= 100
Default10
source?string

Scope to a single source by typed ID (src_…) or slug. Mutually exclusive with org.

org?string

Scope to an org's sources by typed ID (org_…) or slug. Mutually exclusive with source.

include_coverage?boolean

Include coverage-side rows that normally roll up into a canonical release.

include_prereleases?boolean

Include prereleases (canaries / alphas / betas / RCs). Hidden by default to match the source-feed and MCP defaults.

exclude?string

Comma-separated source types to exclude. Allowed: github, scrape, feed, agent.

since?string

Keep only releases published at or after this bound. Accepts an ISO date/datetime or relative shorthand (90d, 4w, 6m, 2y). Filters published_at; undated releases are dropped. Windowed requests bypass the KV cache (X-Cache: BYPASS).

until?string

Keep only releases published at or before this bound. Same input formats as since; a bare date (2026-06-25) includes that whole UTC day.

minImportance?integer

Only include releases with AI-scored importance >= this value (1–5). Releases with no score (null) are excluded when set. Filtered requests bypass the KV cache (X-Cache: BYPASS).

Range1 <= value <= 5

Response Body

Latest releases

application/json
  1. response
releases*array<>
Example Request
curl -X GET 'https://api.releases.sh/v1/releases/latest'
Example Response
{  "releases": [    {      "id": "string",      "version": "string",      "type": "feature",      "title": "string",      "summary": "string",      "titleGenerated": "string",      "titleShort": "string",      "breaking": "unknown",      "importance": 1,      "publishedAt": "string",      "url": "string",      "webUrl": "string",      "media": [        {          "type": "image",          "url": "string",          "alt": "string",          "r2Key": "string",          "r2Url": "string",          "linkUrl": "string"        }      ],      "source": {        "slug": "string",        "name": "string",        "type": "github",        "orgSlug": "string",        "orgName": "string",        "orgAvatarUrl": "string",        "orgGithubHandle": "string",        "kind": "platform"      },      "product": {        "slug": "string",        "name": "string",        "kind": "platform"      },      "groupSlug": "string",      "groupName": "string",      "coverageCount": 0,      "contentChars": 0,      "contentTokens": 0,      "composition": {        "bugs": 0,        "features": 0,        "enhancements": 0      }    }  ]}