Releases Index
Get release by ID
View .md

Get release by ID

GET
/releases/{id}

Returns a single release by its typed rel_… ID. Suppressed and coverage-side rows are excluded via the releases_visible view — they return 404. The content field has CDN-origin media URLs rewritten in-place; the media array is parsed from the raw D1 JSON. Accepts Accept: text/markdown to receive the release formatted as Markdown. Accepts the friendly rel_…-<slug> URL segment form — the trailing slug is ignored for lookup. The response includes webUrl, the canonical releases.sh detail-page URL (Zendesk-style: ID + current title slug).

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

id*string

Response Body

Release detail

application/json
  1. response
id*string
sourceId*string
version*string|null
type*string
Value in"feature""rollup"
title*string
content*string
summary*string|null
titleGenerated*string|null
titleShort*string|null
breaking?string
Value in"unknown""none""minor""major"
importance?|null
migrationNotes?string|null
url*string|null
webUrl?string
contentHash*string|null
media*array<>
publishedAt*string|null
suppressed*boolean|null
suppressedReason*string|null
prerelease*boolean|null
fetchedAt*string|null
sourceName*string|null
sourceSlug*string|null
sourceType*|null
org*|null
product?|null
composition*|null
appStore?|null
video?|null
sourceIsHidden?boolean
Example Request
curl -X GET 'https://api.releases.sh/v1/releases/string'
Example Response
{  "id": "string",  "sourceId": "string",  "version": "string",  "type": "feature",  "title": "string",  "content": "string",  "summary": "string",  "titleGenerated": "string",  "titleShort": "string",  "breaking": "unknown",  "importance": 1,  "migrationNotes": "string",  "url": "string",  "webUrl": "string",  "contentHash": "string",  "media": [    {      "type": "image",      "url": "string",      "alt": "string",      "r2Key": "string",      "r2Url": "string",      "linkUrl": "string"    }  ],  "publishedAt": "string",  "suppressed": true,  "suppressedReason": "string",  "prerelease": true,  "fetchedAt": "string",  "sourceName": "string",  "sourceSlug": "string",  "sourceType": "github",  "org": {    "slug": "string",    "name": "string",    "avatarUrl": "string",    "discovery": "curated",    "isHidden": true  },  "product": {    "slug": "string",    "name": "string",    "kind": "platform"  },  "composition": {    "bugs": 0,    "features": 0,    "enhancements": 0  },  "appStore": {    "platform": "ios",    "iconUrl": "string"  },  "video": {    "provider": "youtube"  },  "sourceIsHidden": true}