Confluent | the Data Streaming Platform

Confluent | the Data Streaming Platform Subjects (v1) API

[![Generally Available](https://img.shields.io/badge/Lifecycle%20Stage-Generally%20Available-%2345c6e8)](#section/Versioning/API-Lifecycle-Policy) The API allows you to create, retrieve, update, and delete schema subjects and versions. Related guide: [Manage Schemas in Confluent Cloud](https://docs.confluent.io/cloud/current/sr/schemas-manage.html#manage-schemas-in-ccloud).

GitHub OpenAPI

Operations 10

Each operation below carries the questions people ask an LLM about it and the instructions they give an agent to run it. Generated by API Evangelist overlay

GET /subjects/{subject}/versions/{version} Get a schema by subject and version · Get schema by version #
Ask an LLM
“How do I fetch a specific version of a schema from Schema Registry?”
“Can I retrieve a soft-deleted schema version too?”
Tell an agent
Get version {version} of the schema under subject {subject}.
Fetch schema version {version} of {subject} even if it was soft-deleted.
DELETE /subjects/{subject}/versions/{version} Delete a schema version from a subject · Delete schema version #
Ask an LLM
“Can I remove one version of a schema without deleting the whole subject?”
“What's the difference between a soft delete and a permanent delete of a schema version?”
Tell an agent destructive · confirm first
Delete version {version} of subject {subject}.
Permanently delete schema version {version} under {subject}.
GET /subjects/{subject}/versions/{version}/referencedby List schemas that reference a schema · List schemas referencing a schema #
Ask an LLM
“Which other schemas depend on this schema version through references?”
“Is anything still referencing a schema version before I delete it?”
Tell an agent
List the schema IDs that reference version {version} of {subject}.
Show which schemas point at {subject} version {version}.
GET /subjects/{subject}/versions/{version}/schema Get only the raw schema string for a version · Get schema string by version #
Ask an LLM
“Can I get just the unescaped schema text for a version, without the wrapper fields?”
“Where do I download the plain schema definition for one subject version?”
Tell an agent
Get the raw schema string for version {version} of {subject}.
Print only the schema body of {subject} version {version}.
GET /subjects/{subject}/versions List versions registered under a subject · List versions under subject #
Ask an LLM
“How many schema versions have been registered for a subject?”
“Can I list only the soft-deleted versions of a subject?”
Tell an agent
List the versions registered under subject {subject}.
Show only the deleted versions of {subject}.
POST /subjects/{subject}/versions Register a new schema version under a subject · Register schema under a subject #
Ask an LLM
“How do I register a new schema with Confluent Schema Registry?”
“Can I register a Protobuf or JSON Schema instead of Avro?”
Tell an agent
Register this schema under subject {subject}: {schema}.
Register a {schemaType} schema {schema} for {subject} and normalize it first.
POST /subjects/{subject} Check whether a schema is already registered · Lookup schema under subject #
Ask an LLM
“Has this exact schema already been registered under a subject?”
“Can I find out a schema's global ID and version without registering it?”
Tell an agent
Check if schema {schema} already exists under subject {subject}.
Look up the version and ID of schema {schema} in {subject}, including deleted ones.
DELETE /subjects/{subject} Delete a subject and all its versions · Delete subject #
Ask an LLM
“Can I delete an entire subject along with its compatibility level?”
“Does a hard delete of a subject require a soft delete first?”
Tell an agent destructive · confirm first
Delete subject {subject}.
Permanently delete subject {subject} and every version under it.
GET /subjects List registered subjects · List subjects #
Ask an LLM
“What subjects are registered in my Schema Registry?”
“Can I list only the subjects whose names start with a certain prefix?”
Tell an agent
List all subjects in the schema registry.
List subjects that start with {prefix}.
GET /subjects/{subject}/metadata Get the latest schema version matching metadata · Retrieve the latest version with the given metadata #
Ask an LLM
“Can I find the newest schema version tagged with a particular metadata key and value?”
“Which schema version under a subject carries a given metadata property?”
Tell an agent
Get the latest version of {subject} whose metadata {key} equals {value}.
Find the most recent {subject} schema tagged with metadata {key}.

Documentation

📖
Documentation
https://docs.confluent.io/cloud/current/api.html
📖
APIReference
https://docs.confluent.io/cloud/current/api.html

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/confluent-the-data-streaming-platform/refs/heads/main/openapi/confluent-the-data-streaming-platform-subjects-v1-api-openapi.yml

Other Resources

🔗
ToolCrosswalk
https://raw.githubusercontent.com/api-evangelist/confluent-the-data-streaming-platform/refs/heads/main/mcp/confluent-the-data-streaming-platform-tool-crosswalk.yml
🔗
DataModel
https://raw.githubusercontent.com/api-evangelist/confluent-the-data-streaming-platform/refs/heads/main/data-model/confluent-the-data-streaming-platform-data-model.yml

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/confluent-the-data-streaming-platform:confluent-the-data-streaming-platform-subjects-v1-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

confluent-the-data-streaming-platform-subjects-v1-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Confluent Cloud Subjects (v1) API
  version: ''
  x-api-id: 46234552-5833-42eb-ba0f-883ad3f70d2b
  x-audience: external-public
  x-logo:
    url: https://assets.confluent.io/m/1661ef5e4ff82d3d/
  description: '# Introduction


    Note


    This documents the collection of Confluent Cloud APIs.'
servers:
- url: https://api.confluent.cloud
  description: Confluent Cloud API
tags:


# --- truncated at 32 KB (50 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/confluent-the-data-streaming-platform/refs/heads/main/openapi/confluent-the-data-streaming-platform-subjects-v1-api-openapi.yml