Releases

{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['entity'], 'properties': {'entity': {'type': 'string', 'description': 'Entity to follow â\x80\x94 an `org_â\x80¦` or `prod_â\x80¦` id (from search / get_* results).'}}}

{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['identifier'], 'properties': {'identifier': {'type': 'string', 'description': "Catalog entry identifier: prod_ id, src_ id, or org-scoped coordinate orgSlug/slug (e.g. 'vercel/nextjs'). Bare slugs without an org prefix are not accepted."}, 'changelog_path': {'type': 'string', 'description': "Specific CHANGELOG path for a source-kind entry (e.g. 'packages/next/CHANGELOG.md'). Passing this implies include_changelog."}, 'changelog_limit': {'type': 'number', 'description': 'Target slice size in characters. Slice ends at a heading boundary. Defaults to 40000 when slicing without a token budget. Passing this implies include_changelog.'}, 'changelog_offset': {'type': 'number', 'description': 'Character offset into the selected CHANGELOG. Snapped forward to the next heading unless 0. Passing this implies include_changelog.'}, 'changelog_tokens': {'type': 'number', 'description': 'Target slice size in tokens (cl100k_base). Takes precedence over changelog_limit. Recommended brackets: 2000, 5000, 10000, 20000. Passing this implies include_changelog.'}, 'include_changelog': {'type': 'boolean', 'description': 'When true, inline the root tracked CHANGELOG for a source-kind entry. Ignored for products.'}}}

{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['slug'], 'properties': {'slug': {'type': 'string', 'description': "Collection slug (e.g. 'frontier-ai-labs')."}}}

{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['slug'], 'properties': {'slug': {'type': 'string', 'description': "Collection slug (e.g. 'frontier-ai-labs')."}, 'limit': {'type': 'integer', 'maximum': 200, 'minimum': 1, 'description': 'Slice size (1â\x80\x93200). Defaults to 20.'}, 'cursor': {'type': 'string', 'description': "Opaque continuation token from a prior call's `_meta.pagination.nextCursor`. Stale cursors are silently ignored â\x80\x94 the call returns a fresh head of the feed."}, 'include_prereleases': {'type': 'boolean', 'description': 'Include prerelease tags (alphas, betas, RCs). Defaults to false so the feed matches the public web view.'}}}

{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {'kind': {'enum': ['platform', 'sdk', 'mobile', 'desktop', 'docs', 'integration', 'tool'], 'type': 'string', 'description': "Filter to releases from sources of a specific kind. Resolves through `source.kind ?? product.kind`, so an SDK repo with no own kind still matches its product's kind. Omit to include all kinds."}, 'type': {'enum': ['feature', 'rollup'], 'type': 'string', 'description': "Filter by release type: 'feature' for individual releases, 'rollup' for seasonal/quarterly catch-all posts. Omit to include both."}, 'limit': {'type': 'integer', 'maximum': 200, 'minimum': 1, 'description': 'Slice size (1â\x80\x93200). Defaults to 10.'}, 'since': {'type': 'string', 'description': 'Keep only releases published at or after this bound. Accepts an ISO date/datetime (`2026-01-01`) or relative shorthand (`90d`, `4w`, `6m`, `2y`). Filters `published_at`; undated releases are dropped.'}, 'until': {'type': 'string', 'description': 'Keep only releases published at or before this bound. Same input formats as `since`.'}, 'cursor': {'type': 'string', 'description': "Opaque continuation token from a prior call's `_meta.pagination.nextCursor`. Pass to fetch the next slice. Stale cursors are silently ignored â\x80\x94 the call returns a fresh head of the feed."}, 'product': {'type': 'string', 'description': "Filter to a product's cross-source release feed. Accepts a prod_ id (expands to ALL sources under the product), a src_ id (single source), or an org-scoped coordinate in the form orgSlug/productSlug (e.g. 'vercel/next-js'). Bare slugs without an org prefix are not accepted. Mirrors the REST ?product= expansion â\x80\x94 multi-source products (e.g. Next.js with GitHub releases + blog) return releases from all of their sources interleaved."}, 'organization': {'type': 'string', 'description': 'Filter to sources belonging to this organization. Accepts an org_ id, slug, or registered domain.'}, 'minImportance': {'type': 'integer', 'maximum': 5, 'minimum': 1, 'description': 'Only include releases with an AI-scored `importance` >= this value (1-5; 5=landmark, 1=housekeeping). Releases with no score (unscored) are excluded when this is set. Mirrors the REST `?minImportance=` filter.'}, 'include_coverage': {'type': 'boolean', 'description': 'Include releases grouped as coverage of another (e.g. marketing posts that re-announce a platform release). Defaults to false so each underlying launch appears once.'}, 'include_prereleases': {'type': 'boolean', 'description': 'Include prerelease tags (alphas, betas, RCs, canaries). Defaults to false so the feed matches the public web view.'}}}

{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['identifier'], 'properties': {'identifier': {'type': 'string', 'description': 'Organization identifier. Accepts an org_ id, slug, domain, name, or account handle.'}, 'include_overview': {'type': 'boolean', 'description': 'When true, inline the full AI-generated overview instead of the default first-paragraph preview.'}}}

{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {'limit': {'type': 'integer', 'maximum': 100, 'minimum': 1, 'description': 'Entries per page (1â\x80\x93100). Defaults to 30.'}, 'cursor': {'type': 'string', 'description': "Opaque cursor from a previous page's `_meta.pagination.nextCursor`."}}}

{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['id'], 'properties': {'id': {'type': 'string', 'description': "Release id â\x80\x94 'rel_<nanoid>' or a bare 21-char nanoid"}}}

{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {'kind': {'enum': ['platform', 'sdk', 'mobile', 'desktop', 'docs', 'integration', 'tool'], 'type': 'string', 'description': "Filter to catalog entries of a specific kind. Matches each row's own kind (a product's kind, or a standalone source's kind) â\x80\x94 no sourceâ\x86\x92product inheritance on this catalog surface. Omit to include all kinds."}, 'page': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 1, 'description': '1-based page number. Defaults to 1.'}, 'limit': {'type': 'integer', 'maximum': 200, 'minimum': 1, 'description': 'Entries per page (1â\x80\x93200). Defaults to 50.'}, 'organization': {'type': 'string', 'description': 'Organization to scope to. Accepts an org_ id, slug, domain, or name.'}}}

{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {'page': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 1, 'description': '1-based page number. Defaults to 1.'}, 'limit': {'type': 'integer', 'maximum': 200, 'minimum': 1, 'description': 'Entries per page (1â\x80\x93200). Defaults to 50.'}}}

{'type': 'object', 'properties': {}}

{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {'page': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 1, 'description': '1-based page number. Defaults to 1.'}, 'limit': {'type': 'integer', 'maximum': 200, 'minimum': 1, 'description': 'Entries per page (1â\x80\x93200). Defaults to 50.'}, 'query': {'type': 'string', 'description': 'Search across org name, slug, domain, and account handles'}, 'category': {'type': 'string', 'description': 'Filter to a single category slug (e.g. `ai`, `devops`). Aliases (e.g. `e-commerce`) resolve to their canonical category (`commerce`); unknown values are ignored (unfiltered).'}, 'platform': {'type': 'string', 'description': 'Filter to orgs with an account on this platform'}, 'include_empty': {'type': 'boolean', 'description': 'Include orgs with zero indexed releases. Default false â\x80\x94 empty orgs are stubs from in-flight discovery or broken parsers and surface as noise on the public catalog.'}}}

{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {'id': {'type': 'string', 'description': 'Show one webhook (with recent deliveries) instead of the full list.'}, 'enabled': {'type': 'boolean', 'description': 'Filter to enabled or disabled webhooks.'}, 'workspace': {'type': 'string', 'description': 'Workspace id or slug. Omit for your personal webhooks.'}}}

{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['domain'], 'properties': {'domain': {'type': 'string', 'description': 'Domain to resolve. Any URL-shaped form is accepted; the server normalizes it.'}}}

{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['action'], 'properties': {'id': {'type': 'string', 'description': 'Webhook id â\x80\x94 required for update, delete, test, and rotate_secret.'}, 'org': {'type': 'string', 'description': 'Org slug or org_â\x80¦ id. Required for an org-scoped create.'}, 'url': {'type': 'string', 'description': 'Delivery URL. Required for create.'}, 'scope': {'enum': ['org', 'follows'], 'type': 'string', 'description': 'Create only. "follows" is personal-only and defaults org-scoped when omitted.'}, 'action': {'enum': ['create', 'update', 'delete', 'test', 'rotate_secret'], 'type': 'string'}, 'format': {'enum': ['json', 'slack', 'discord'], 'type': 'string', 'description': 'Delivery format.'}, 'source': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'description': 'Source slug or src_â\x80¦ id to narrow an org-scoped webhook. null clears it on update.'}, 'enabled': {'type': 'boolean', 'description': 'Update only. Enable or disable delivery.'}, 'product': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'description': 'Product slug or prod_â\x80¦ id to narrow an org-scoped webhook. null clears it on update.'}, 'workspace': {'type': 'string', 'description': 'Workspace id or slug. Omit to act on your personal webhooks.'}, 'description': {'type': 'string', 'description': 'Freeform label for the webhook.'}, 'releaseType': {'enum': ['feature', 'rollup'], 'type': 'string', 'description': 'Optional filter on release taxonomy type.'}}}

{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['query'], 'properties': {'kind': {'enum': ['platform', 'sdk', 'mobile', 'desktop', 'docs', 'integration', 'tool'], 'type': 'string', 'description': "Filter to a specific source/product kind. Release hits resolve through `source.kind ?? product.kind`; catalog hits filter on the row's own kind. The orgs and collections sections are unaffected; changelog chunk hits are unaffected."}, 'mode': {'enum': ['lexical', 'semantic', 'hybrid'], 'type': 'string', 'description': "Release-retrieval strategy. 'hybrid' (default) fuses FTS + vector results. 'lexical' is legacy FTS only. 'semantic' is vectors only. Falls back to lexical if vector infra is unavailable."}, 'type': {'type': 'array', 'items': {'enum': ['orgs', 'catalog', 'releases', 'collections'], 'type': 'string'}, 'description': "Which sections to return. Omit to return all four. Use to skip expensive paths â\x80\x94 e.g. ['catalog'] for registry-only lookups, ['releases'] for pure release search, ['collections'] for a quick playlist lookup."}, 'limit': {'type': 'number', 'description': 'Max results per section (default 20)'}, 'query': {'type': 'string', 'description': 'Search query'}, 'since': {'type': 'string', 'description': "Keep only release hits published at or after this bound. Accepts an ISO date/datetime (`2026-01-01`) or relative shorthand (`90d`, `4w`, `6m`, `2y`). Filters `published_at`; undated releases are dropped. Only the releases section is affected â\x80\x94 great for capability-discovery queries like 'who added X in the last 90 days'."}, 'until': {'type': 'string', 'description': 'Keep only release hits published at or before this bound. Same input formats as `since`.'}, 'domain': {'type': 'string', 'description': "Scope to the org owning this domain. Input is normalized (scheme/path/www stripped, lowercased), so `https://vercel.com/` and `vercel.com` both work. Falls back to a 'no match' message when the domain isn't owned by anything indexed. Use this instead of `organization` when you have a URL-shaped input."}, 'entity': {'type': 'string', 'description': "Scope release results to one catalog entry. Accepts a prod_ id (expands to every source under the product), a src_ id, or an org-scoped coordinate in the form orgSlug/slug (e.g. 'vercel/nextjs'). Bare slugs without an org prefix are not accepted."}, 'product': {'type': 'string', 'description': "Scope release results to a specific product's sources. Accepts a prod_ id or an org-scoped coordinate in the form orgSlug/productSlug (e.g. 'vercel/next-js'). Bare slugs without an org prefix are not accepted. When both `entity` and `product` are supplied, `entity` takes precedence. The resolved product coordinate is echoed on `_meta.search.product`."}, 'organization': {'type': 'string', 'description': 'Scope release results to sources belonging to this organization. Accepts an org_ id, slug, or registered domain.'}, 'include_empty': {'type': 'boolean', 'description': 'Include orgs with zero indexed releases in the `orgs` section. Default false â\x80\x94 empty orgs are stubs and surface as noise. Scoping by `domain` ignores this and always returns the resolved org.'}, 'include_coverage': {'type': 'boolean', 'description': 'Include releases grouped as coverage of another (e.g. marketing posts that re-announce a platform release). Defaults to false so each underlying launch appears once.'}}}

{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['entity'], 'properties': {'entity': {'type': 'string', 'description': 'Entity to unfollow â\x80\x94 an `org_â\x80¦` or `prod_â\x80¦` id.'}}}

{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['package', 'from', 'to'], 'properties': {'to': {'type': 'string', 'description': "Version you're upgrading TO (inclusive)."}, 'from': {'type': 'string', 'description': "Version you're upgrading FROM (exclusive)."}, 'package': {'type': 'string', 'description': 'Package identifier â\x80\x94 a source slug or a GitHub "owner/repo" coordinate.'}, 'ecosystem': {'enum': ['npm', 'pypi', 'github'], 'type': 'string', 'description': 'Optional resolution hint; "github" enables matching a bare owner/repo.'}, 'minImportance': {'type': 'integer', 'maximum': 5, 'minimum': 1, 'description': 'Only include entries with an AI-scored `importance` >= this value (1-5; 5=landmark, 1=housekeeping). Entries with no score (unscored) are excluded when this is set.'}}}