Releases Index
Get source detail
View .md

Get source detail

GET
/sources/{slug}

Resolves by slug or src_… ID on the bare path, or by org-scoped slug pair. Cursor-paginated releases array (?cursor= opaque cursor from a prior response's pagination.nextCursor, ?limit= capped at 100); ?include_coverage=true exposes coverage rows; ?include_prereleases=true includes pre-release entries.

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

Source detail with paginated releases

  1. response
id*string
slug*string
name*string
type*string
Value in"github""scrape""feed""agent""appstore""video"
url*string
orgId*string|null
productId*string|null
productSlug*string|null
isHidden*boolean
discovery?string
Value in"curated""agent""on_demand"
fetchPriority?|null
isPrimary*boolean
metadata*string
changelogUrl?string|null
hasChangelogFile?boolean
org*|null
releaseCount*integer
Range0 <= value <= 9007199254740991
releasesLast30Days*integer
Range0 <= value <= 9007199254740991
avgReleasesPerWeek*number
latestVersion*string|null
latestDate*string|null
lastFetchedAt*string|null
lastPolledAt*string|null
changeDetectedAt?string|null
trackingSince*string
releases*array<>
pagination*
summaries*
kind?|null
stars?|null
starsFetchedAt?string|null
notice?|null
Example Request
curl -X GET 'https://api.releases.sh/v1/sources/string'
Example Response
{  "id": "string",  "slug": "string",  "name": "string",  "type": "github",  "url": "string",  "orgId": "string",  "productId": "string",  "productSlug": "string",  "isHidden": true,  "discovery": "curated",  "fetchPriority": "normal",  "isPrimary": true,  "metadata": "string",  "changelogUrl": "string",  "hasChangelogFile": true,  "org": {    "id": "string",    "slug": "string",    "name": "string"  },  "releaseCount": 0,  "releasesLast30Days": 0,  "avgReleasesPerWeek": 0,  "latestVersion": "string",  "latestDate": "string",  "lastFetchedAt": "string",  "lastPolledAt": "string",  "changeDetectedAt": "string",  "trackingSince": "string",  "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  },  "summaries": {    "rolling": {      "year": -9007199254740991,      "month": -9007199254740991,      "windowDays": -9007199254740991,      "summary": "string",      "releaseCount": 0,      "generatedAt": "string"    },    "monthly": [      {        "year": -9007199254740991,        "month": -9007199254740991,        "windowDays": -9007199254740991,        "summary": "string",        "releaseCount": 0,        "generatedAt": "string"      }    ]  },  "kind": "platform",  "stars": 0,  "starsFetchedAt": "string",  "notice": {    "message": "string",    "linkText": "string",    "coordinate": "string",    "href": "http://example.com"  }}
GET
/orgs/{orgSlug}/sources/{sourceSlug}

Resolves by slug or src_… ID on the bare path, or by org-scoped slug pair. Cursor-paginated releases array (?cursor= opaque cursor from a prior response's pagination.nextCursor, ?limit= capped at 100); ?include_coverage=true exposes coverage rows; ?include_prereleases=true includes pre-release entries.

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

Source detail with paginated releases

  1. response
id*string
slug*string
name*string
type*string
Value in"github""scrape""feed""agent""appstore""video"
url*string
orgId*string|null
productId*string|null
productSlug*string|null
isHidden*boolean
discovery?string
Value in"curated""agent""on_demand"
fetchPriority?|null
isPrimary*boolean
metadata*string
changelogUrl?string|null
hasChangelogFile?boolean
org*|null
releaseCount*integer
Range0 <= value <= 9007199254740991
releasesLast30Days*integer
Range0 <= value <= 9007199254740991
avgReleasesPerWeek*number
latestVersion*string|null
latestDate*string|null
lastFetchedAt*string|null
lastPolledAt*string|null
changeDetectedAt?string|null
trackingSince*string
releases*array<>
pagination*
summaries*
kind?|null
stars?|null
starsFetchedAt?string|null
notice?|null
Example Request
curl -X GET 'https://api.releases.sh/v1/orgs/string/sources/string'
Example Response
{  "id": "string",  "slug": "string",  "name": "string",  "type": "github",  "url": "string",  "orgId": "string",  "productId": "string",  "productSlug": "string",  "isHidden": true,  "discovery": "curated",  "fetchPriority": "normal",  "isPrimary": true,  "metadata": "string",  "changelogUrl": "string",  "hasChangelogFile": true,  "org": {    "id": "string",    "slug": "string",    "name": "string"  },  "releaseCount": 0,  "releasesLast30Days": 0,  "avgReleasesPerWeek": 0,  "latestVersion": "string",  "latestDate": "string",  "lastFetchedAt": "string",  "lastPolledAt": "string",  "changeDetectedAt": "string",  "trackingSince": "string",  "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  },  "summaries": {    "rolling": {      "year": -9007199254740991,      "month": -9007199254740991,      "windowDays": -9007199254740991,      "summary": "string",      "releaseCount": 0,      "generatedAt": "string"    },    "monthly": [      {        "year": -9007199254740991,        "month": -9007199254740991,        "windowDays": -9007199254740991,        "summary": "string",        "releaseCount": 0,        "generatedAt": "string"      }    ]  },  "kind": "platform",  "stars": 0,  "starsFetchedAt": "string",  "notice": {    "message": "string",    "linkText": "string",    "coordinate": "string",    "href": "http://example.com"  }}