---
title: API Reference
description: >-
  Every public endpoint of the Releases REST API, with parameters, schemas, code
  samples, and a try-it playground.
---
# API Reference

Every public endpoint of the Releases REST API, generated from the [OpenAPI 3.1 spec](https://api.releases.sh/v1/openapi.json). 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](/docs/api/rest#authentication).
- **Conventions:** pagination, date filters, and resource shapes are covered in [REST API](/docs/api/rest). Error responses are in [Errors](/docs/api/errors).

## Releases

- `GET` [Latest releases (cross-source feed)](/docs/api/reference/releases/latest-releases)
- `GET` [Get release coverage cluster](/docs/api/reference/releases/get-release-coverage-cluster)
- `GET` [Get release by ID](/docs/api/reference/releases/get-release-by-id)
- `GET` [Changelog entries between two versions of a package (upgrade intelligence)](/docs/api/reference/releases/whats-changed)

## Search

- `GET` [Unified search across orgs, catalog, collections, releases, and chunks](/docs/api/reference/search/search)

## Orgs

- `GET` [List organizations](/docs/api/reference/orgs/list-organizations)
- `GET` [Get organization detail](/docs/api/reference/orgs/get-organization-detail)
- `GET` [Export the org as a releases.json manifest](/docs/api/reference/orgs/export-manifest)
- `GET` [Collections this org belongs to](/docs/api/reference/orgs/org-collections)
- `GET` [List org social/platform accounts](/docs/api/reference/orgs/list-org-accounts)
- `GET` [List org tags](/docs/api/reference/orgs/list-org-tags)
- `GET` [Org release feed (cursor-paginated)](/docs/api/reference/orgs/org-release-feed)
- `GET` [Resolve an org-scoped slug to a product or source](/docs/api/reference/orgs/resolve-a-slug)

## Products

- `GET` [List products](/docs/api/reference/products/list-products)
- `GET` [List an organization's products](/docs/api/reference/products/list-org-products)
- `GET` [Get product detail](/docs/api/reference/products/get-product-detail)
- `GET` [List product tags](/docs/api/reference/products/list-product-tags)
- `GET` [Collections this product belongs to](/docs/api/reference/products/product-collections)

## Sources

- `GET` [List sources](/docs/api/reference/sources/list-sources)
- `POST` [Publish a batch of releases](/docs/api/reference/sources/publish-a-batch-of-releases)
- `GET` [Source release feed](/docs/api/reference/sources/source-release-feed)
- `GET` [Get source changelog](/docs/api/reference/sources/get-source-changelog)
- `GET` [Get source detail](/docs/api/reference/sources/get-source-detail)

## Collections

- `GET` [List curated collections](/docs/api/reference/collections/list-curated-collections)
- `GET` [Get a collection's detail page payload](/docs/api/reference/collections/get-collection)
- `GET` [Interleaved release feed across a collection's members](/docs/api/reference/collections/collection-release-feed)
- `GET` [Daily AI summaries for a collection](/docs/api/reference/collections/daily-summaries)
- `GET` [Weekly AI digests for a collection](/docs/api/reference/collections/weekly-digests)
- `GET` [A collection's newest weekly digest, with resolved release links](/docs/api/reference/collections/latest-digest)
- `GET` [One collection's weekly digest, with resolved release links](/docs/api/reference/collections/digest-by-week)

## Categories & tags

- `GET` [List all categories with org and product counts](/docs/api/reference/taxonomy/list-categories)
- `GET` [Get category detail with member orgs and products](/docs/api/reference/taxonomy/get-category)
- `GET` [Cross-org release feed scoped to a category](/docs/api/reference/taxonomy/category-release-feed)
- `GET` [Get tag detail with member orgs and products](/docs/api/reference/taxonomy/get-tag)

## Related

- `GET` [Releases semantically similar to an anchor release](/docs/api/reference/related/related-releases)
- `GET` [Sources semantically similar to an anchor source](/docs/api/reference/related/related-sources)

## Overviews

- `GET` [Get org overview](/docs/api/reference/overviews/get-org-overview)
- `GET` [Get product overview](/docs/api/reference/overviews/get-product-overview)

## Lookups

- `POST` [On-demand GitHub source materialization](/docs/api/reference/lookups/materialize-a-github-source)
- `GET` [Resolve a bare source slug to its canonical org-scoped home](/docs/api/reference/lookups/source-by-slug)
- `GET` [Resolve a GitHub owner/repo coordinate to an indexed source (read-only, no materialize)](/docs/api/reference/lookups/source-by-coordinate)
- `GET` [Resolve a bare product slug to its canonical org-scoped home](/docs/api/reference/lookups/product-by-slug)
- `GET` [Resolve a domain to its owning org and any matching products](/docs/api/reference/lookups/org-by-domain)

## Account

- `GET` [List your publish tokens](/docs/api/reference/account/list-your-publish-tokens)
- `POST` [Mint a publish token for one of your sources](/docs/api/reference/account/mint-a-publish-token)
- `DELETE` [Revoke a publish token](/docs/api/reference/account/revoke-a-publish-token)
- `GET` [List follows](/docs/api/reference/account/list-follows)
- `POST` [Follow an org or product](/docs/api/reference/account/follow-an-org-or-product)
- `DELETE` [Unfollow an org or product](/docs/api/reference/account/unfollow-an-org-or-product)
- `GET` [Get the personalized release feed](/docs/api/reference/account/personalized-feed)
- `GET` [List your semantic alerts](/docs/api/reference/account/list-your-semantic-alerts)
- `POST` [Create a semantic alert](/docs/api/reference/account/create-a-semantic-alert)
- `GET` [Get one of your semantic alerts](/docs/api/reference/account/get-a-semantic-alert)
- `PATCH` [Update a semantic alert](/docs/api/reference/account/update-a-semantic-alert)
- `DELETE` [Delete a semantic alert](/docs/api/reference/account/delete-a-semantic-alert)
- `GET` [List your workspaces](/docs/api/reference/account/list-your-workspaces)

## API keys

- `DELETE` [Revoke the presenting user API key](/docs/api/reference/api-keys/revoke-the-current-key)
- `GET` [List user API keys](/docs/api/reference/api-keys/list-user-api-keys)
- `POST` [Create a user API key](/docs/api/reference/api-keys/create-a-user-api-key)
- `DELETE` [Revoke a user API key](/docs/api/reference/api-keys/revoke-a-user-api-key)

## Webhooks

- `GET` [List personal webhook subscriptions](/docs/api/reference/webhooks/list-personal-webhooks)
- `POST` [Create a personal webhook subscription](/docs/api/reference/webhooks/create-a-personal-webhook)
- `GET` [Get a personal webhook subscription](/docs/api/reference/webhooks/get-a-personal-webhook)
- `PATCH` [Update a personal webhook subscription](/docs/api/reference/webhooks/update-a-personal-webhook)
- `DELETE` [Delete a personal webhook subscription](/docs/api/reference/webhooks/delete-a-personal-webhook)
- `POST` [Rotate a personal webhook signing key](/docs/api/reference/webhooks/rotate-a-personal-secret)
- `POST` [Queue a personal webhook test delivery](/docs/api/reference/webhooks/test-a-personal-webhook)
- `GET` [List recent personal webhook deliveries](/docs/api/reference/webhooks/personal-deliveries)
- `GET` [List workspace webhook subscriptions](/docs/api/reference/webhooks/list-workspace-webhooks)
- `POST` [Create a workspace webhook subscription](/docs/api/reference/webhooks/create-a-workspace-webhook)
- `GET` [Get a workspace webhook subscription](/docs/api/reference/webhooks/get-a-workspace-webhook)
- `PATCH` [Update a workspace webhook subscription](/docs/api/reference/webhooks/update-a-workspace-webhook)
- `DELETE` [Delete a workspace webhook subscription](/docs/api/reference/webhooks/delete-a-workspace-webhook)
- `POST` [Rotate a workspace webhook signing key](/docs/api/reference/webhooks/rotate-a-workspace-secret)
- `POST` [Queue a workspace webhook test delivery](/docs/api/reference/webhooks/test-a-workspace-webhook)
- `GET` [List recent workspace webhook deliveries](/docs/api/reference/webhooks/workspace-deliveries)

## Listing & claims

- `GET` [Listing-lane capability flags](/docs/api/reference/listing/capabilities)
- `POST` [Validate a domain's releases.json and preview its listing](/docs/api/reference/listing/validate-a-manifest)
- `POST` [Activate an instant stub listing for an unlisted domain](/docs/api/reference/listing/activate-a-listing)
- `POST` [Start (or fetch) an ownership claim on a listed domain](/docs/api/reference/listing/start-a-claim)
- `POST` [Check the proof for a pending ownership claim](/docs/api/reference/listing/verify-a-claim)
- `GET` [List the caller's own ownership claims](/docs/api/reference/listing/list-your-claims)
- `DELETE` [Release one of your ownership claims](/docs/api/reference/listing/release-a-claim)
- `POST` [Self-serve promotion of a claimed stub org to tracked](/docs/api/reference/listing/promote-a-listing)

## Stats & feedback

- `GET` [Public registry rollup with per-source activity](/docs/api/reference/site/registry-stats)
- `GET` [Current site-wide notice](/docs/api/reference/site/current-site-wide-notice)
- `POST` [Submit product feedback](/docs/api/reference/site/submit-product-feedback)
- `POST` [Submit a source recommendation](/docs/api/reference/site/recommend-a-source)