API Reference
Every public endpoint of the Releases REST API, generated from the OpenAPI 3.1 spec. Each page lists the endpoint's parameters, request and response schemas, and code samples, and has a playground for sending a real request.
- Base URL:
https://api.releases.sh/v1 - Auth: most reads are public. Account and write endpoints take a Bearer token. See Authentication.
- Conventions: pagination, date filters, and resource shapes are covered in REST API. Error responses are in Errors.
Releases
GETLatest releases (cross-source feed)GETGet release coverage clusterGETGet release by IDGETChangelog entries between two versions of a package (upgrade intelligence)
Search
Orgs
GETList organizationsGETGet organization detailGETExport the org as a releases.json manifestGETCollections this org belongs toGETList org social/platform accountsGETList org tagsGETOrg release feed (cursor-paginated)GETResolve an org-scoped slug to a product or source
Products
GETList productsGETList an organization's productsGETGet product detailGETList product tagsGETCollections this product belongs to
Sources
GETList sourcesPOSTPublish a batch of releasesGETSource release feedGETGet source changelogGETGet source detail
Collections
GETList curated collectionsGETGet a collection's detail page payloadGETInterleaved release feed across a collection's membersGETDaily AI summaries for a collectionGETWeekly AI digests for a collectionGETA collection's newest weekly digest, with resolved release linksGETOne collection's weekly digest, with resolved release links
Categories & tags
GETList all categories with org and product countsGETGet category detail with member orgs and productsGETCross-org release feed scoped to a categoryGETGet tag detail with member orgs and products
Related
GETReleases semantically similar to an anchor releaseGETSources semantically similar to an anchor source
Overviews
GETGet org overviewGETGet product overview
Lookups
POSTOn-demand GitHub source materializationGETResolve a bare source slug to its canonical org-scoped homeGETResolve a GitHub owner/repo coordinate to an indexed source (read-only, no materialize)GETResolve a bare product slug to its canonical org-scoped homeGETResolve a domain to its owning org and any matching products
Account
GETList your publish tokensPOSTMint a publish token for one of your sourcesDELETERevoke a publish tokenGETList followsPOSTFollow an org or productDELETEUnfollow an org or productGETGet the personalized release feedGETList your semantic alertsPOSTCreate a semantic alertGETGet one of your semantic alertsPATCHUpdate a semantic alertDELETEDelete a semantic alertGETList your workspaces
API keys
DELETERevoke the presenting user API keyGETList user API keysPOSTCreate a user API keyDELETERevoke a user API key
Webhooks
GETList personal webhook subscriptionsPOSTCreate a personal webhook subscriptionGETGet a personal webhook subscriptionPATCHUpdate a personal webhook subscriptionDELETEDelete a personal webhook subscriptionPOSTRotate a personal webhook signing keyPOSTQueue a personal webhook test deliveryGETList recent personal webhook deliveriesGETList workspace webhook subscriptionsPOSTCreate a workspace webhook subscriptionGETGet a workspace webhook subscriptionPATCHUpdate a workspace webhook subscriptionDELETEDelete a workspace webhook subscriptionPOSTRotate a workspace webhook signing keyPOSTQueue a workspace webhook test deliveryGETList recent workspace webhook deliveries
Listing & claims
GETListing-lane capability flagsPOSTValidate a domain's releases.json and preview its listingPOSTActivate an instant stub listing for an unlisted domainPOSTStart (or fetch) an ownership claim on a listed domainPOSTCheck the proof for a pending ownership claimGETList the caller's own ownership claimsDELETERelease one of your ownership claimsPOSTSelf-serve promotion of a claimed stub org to tracked