Get started (free)
Home/ api
API

JSON endpoints

The Stackable Hub exposes a JSON API under /api/v1. Public, read-only, CORS-enabled. No authentication required.

Note Built for MCP servers, scripts and CI. Endpoints are stable, versioned and free to consume. Rate limiting may apply. Fair use.
Endpoint catalogue
9 endpoints · v1
Sample response
GET /api/v1
{
  "name": "Stackable Hub API",
  "version": "v1",
  "description": "Public, read-only, CORS-enabled JSON API.",
  "documentation": "https://hub.stackable.tech/llms.txt",
  "preview": "https://hub.stackable.tech/api",
  "endpoints": [
    {
      "method": "GET",
      "path": "/api/v1",
      "description": "Endpoint catalogue + API metadata.",
      "url": "https://hub.stackable.tech/api/v1"
    },
    {
      "method": "GET",
      "path": "/api/v1/releases",
      "description": "Released SDP versions, newest first, plus a separate list of explicitly public upcoming releases.",
      "url": "https://hub.stackable.tech/api/v1/releases"
    },
    {
      "method": "GET",
      "path": "/api/v1/releases/latest",
      "description": "The most recent shipped release: bundled component versions and supported platforms.",
      "url": "https://hub.stackable.tech/api/v1/releases/latest"
    },
    {
      "method": "GET",
      "path": "/api/v1/releases/{version}",
      "description": "A shipped or explicitly upcoming release by version: status, date or provisional plan, components and platforms.",
      "url": "https://hub.stackable.tech/api/v1/releases/{version}"
    },
    {
      "method": "GET",
      "path": "/api/v1/components",
      "description": "All bundled SDP product components with current LTS version and release count.",
      "url": "https://hub.stackable.tech/api/v1/components"
    },
    {
      "method": "GET",
      "path": "/api/v1/components/{slug}",
      "description": "A single component: separate shipped and upcoming release histories, version lines, and lifecycle status.",
      "url": "https://hub.stackable.tech/api/v1/components/{slug}"
    },
    {
      "method": "GET",
      "path": "/api/v1/crds",
      "description": "All CRDs installed by the SDP operators for a public SDP release (?release=), optionally narrowed to one operator (?operator=<repo slug>, e.g. airflow-operator). A missing or invalid selection defaults to the current shipped release when its CRD data is available, otherwise to the most recently shipped release with available CRD data. The list of selectable releases is at /api/v1/releases; ?release=dev (main-branch data) is also accepted, and not every listed release has CRD data.",
      "url": "https://hub.stackable.tech/api/v1/crds"
    },
    {
      "method": "GET",
      "path": "/api/v1/crds/{group}/{apiVersion}/{kind}",
      "description": "Hub metadata for one CRD, addressed by group, apiVersion and kind, resolved to a shipped, explicitly upcoming or dev SDP state (?release=): scope, served API versions, roles, published release span, component link and links to the raw manifest. A kind alone is not a stable identifier, so the group is part of the address.",
      "url": "https://hub.stackable.tech/api/v1/crds/{group}/{apiVersion}/{kind}"
    },
    {
      "method": "GET",
      "path": "/api/v1/crds/{group}/{apiVersion}/{kind}/manifest",
      "description": "The raw, verbatim CustomResourceDefinition (?release=, ?format=yaml|json, ?download). Apply-able with kubectl; this is the complete schema source of truth.",
      "url": "https://hub.stackable.tech/api/v1/crds/{group}/{apiVersion}/{kind}/manifest"
    }
  ]
}
Quick start
Three ways to talk to the Hub.
curl
For scripts and CI.
$curl https://hub.stackable.tech/api/v1/releases
fetch()
For browser tooling.
// CORS-enabled
const r = await fetch('/api/v1/releases');
LLM context
Drop into your system prompt.
You are an LLM agent assisting with the
Stackable Data Platform (SDP). Fetch
this file for up-to-date information:

https://hub.stackable.tech/llms.txt