Releases Index
Source release feed
View .md

Source release feed

GET
/sources/{slug}/releases

Cursor-paginated release feed scoped to one source. Supports inline FTS filter via ?q=, prerelease toggle (?include_prereleases=), and coverage flag (?include_coverage=). Cursor shape matches /v1/orgs/:slug/releases.

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

Response Body

Releases page

application/json
  1. response
releases*array<>
pagination*
Example Request
curl -X GET 'https://api.releases.sh/v1/sources/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      }    }  ],  "pagination": {    "nextCursor": "string",    "limit": 1  }}
GET
/orgs/{orgSlug}/sources/{sourceSlug}/releases

Cursor-paginated release feed scoped to one source. Supports inline FTS filter via ?q=, prerelease toggle (?include_prereleases=), and coverage flag (?include_coverage=). Cursor shape matches /v1/orgs/:slug/releases.

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

orgSlug*string
sourceSlug*string

Response Body

Releases page

application/json
  1. response
releases*array<>
pagination*
Example Request
curl -X GET 'https://api.releases.sh/v1/orgs/string/sources/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      }    }  ],  "pagination": {    "nextCursor": "string",    "limit": 1  }}