Releases Index
Category release feed
View .md

Cross-org release feed scoped to a category

GET
/categories/{slug}/releases

Aggregated release feed for a category rollup. Mirrors /v1/collections/:slug/releases (cursor pagination, content negotiation). Effective category is denormalized on releases.effective_category (COALESCE(product.category, org.category) stamped at insert / recompute) so the feed can seek by category instead of full-scanning releases (#886).

Non-canonical slugs that match a known alias resolve to the canonical category internally (no redirect — feeds aren't bookmarked). Content negotiation: Accept: text/markdown returns a Markdown-rendered version.

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.

Path Parameters

slug*string

Query Parameters

cursor?string

Opaque pagination cursor from a previous response's pagination.nextCursor.

limit?integer

Max releases per page. Clamped to [1, 100].

Range1 <= value <= 100
Default20
include_prereleases?boolean

Include alpha/beta/rc/preview/nightly releases. Default false.

orgs?string

Comma-separated org slugs to narrow the feed to a subset of the category's orgs. Unknown slugs are silently dropped; passing an orgs= value that resolves to nothing returns releases: []. Omit to include all orgs in the category.

source_type?string

Comma-separated source types (github, feed, scrape, agent) to narrow the feed by ingest channel. Unknown tokens are silently dropped. Omit to include all source types.

Response Body

Category release feed (or Markdown when Accept: text/markdown is sent)

application/json
  1. response
releases*array<>
pagination*
Example Request
curl -X GET 'https://api.releases.sh/v1/categories/string/releases'
Example Response
{  "releases": [    {      "id": "string",      "version": "string",      "title": "string",      "summary": "string",      "content": "string",      "publishedAt": "string",      "fetchedAt": "string",      "url": "string",      "media": [        {          "type": "image",          "url": "string",          "alt": "string",          "r2Key": "string",          "r2Url": "string",          "linkUrl": "string"        }      ],      "type": "feature",      "prerelease": true,      "titleGenerated": "string",      "titleShort": "string",      "breaking": "unknown",      "importance": 1,      "coverageCount": 0,      "contentChars": 0,      "contentTokens": 0,      "composition": {        "bugs": 0,        "features": 0,        "enhancements": 0      },      "source": {        "slug": "string",        "name": "string",        "type": "string"      },      "org": {        "slug": "string",        "name": "string"      },      "product": {        "slug": "string",        "name": "string"      },      "groupSlug": "string",      "groupName": "string"    }  ],  "pagination": {    "nextCursor": "string",    "limit": 1  }}