v3

latestOpenAPI 3.1.02026-07-31550239.5 KB
Taxonomy

Cross-org release feed scoped to a category

Aggregated release feed for a category rollup. Mirrors /v1/collections/:slug/releases (cursor pagination, content negotiation). Effective category is denormalized on releases.effective_category (COALESCE(product.category, org.category) stamped at insert / recompute) so the feed can seek by category instead of full-scanning releases (#886).

Non-canonical slugs that match a known alias resolve to the canonical category internally (no redirect — feeds aren't bookmarked). Content negotiation: Accept: text/markdown returns a Markdown-rendered version.

get/categories/{slug}/releases

Path parameters

slugstring required

Query parameters

cursorstring

Opaque pagination cursor from a previous response's pagination.nextCursor.

limitinteger

Max releases per page. Clamped to [1, 100].

include_prereleasesboolean

Include alpha/beta/rc/preview/nightly releases. Default false.

orgsstring

Comma-separated org slugs to narrow the feed to a subset of the category's orgs. Unknown slugs are silently dropped; passing an orgs= value that resolves to nothing returns releases: []. Omit to include all orgs in the category.

source_typestring

Comma-separated source types (github, feed, scrape, agent) to narrow the feed by ingest channel. Unknown tokens are silently dropped. Omit to include all source types.

Response

Category release feed (or Markdown when Accept: text/markdown is sent)