Releases Index
Org release feed
View .md

Org release feed (cursor-paginated)

GET
/orgs/{slug}/releases

Returns the org's combined release feed across all sources, newest-first. Cursor-paginated — pass nextCursor from the previous response as ?cursor= on the next request. Accepts ?source_type=, ?kind=, ?include_coverage=true, ?include_prereleases=true, and ?q= full-text search.

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 cursor from a previous response's pagination.nextCursor.

limit?integer

Max releases to return. Defaults to 20, capped at 100.

Range1 <= value <= 100
Default20
source_type?string

Filter by source type (e.g. github, feed, scrape).

kind?string

Filter by resolved entity kind (source.kind ?? product.kind). One of: platform, sdk, mobile, desktop, docs, integration, tool.

Value in"platform""sdk""mobile""desktop""docs""integration""tool"
product?string

Restrict the feed to one product (slug or prod_… id, scoped to this org). Unknown product → 404.

include_coverage?boolean

When true, include coverage-side rows (hidden by default).

include_prereleases?boolean

When true, include pre-release entries.

q?string

Full-text search query applied to release title and content.

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.

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.

Range1 <= value <= 5

Response Body

Release feed

  1. response
releases*array<>
pagination*
Example Request
curl -X GET 'https://api.releases.sh/v1/orgs/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",        "appStore": {          "platform": "ios",          "iconUrl": "string"        },        "video": {          "provider": "youtube"        }      },      "product": {        "slug": "string",        "name": "string"      },      "groupSlug": "string",      "groupName": "string"    }  ],  "pagination": {    "nextCursor": "string",    "limit": 1  }}