Confluent

Confluent 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 11

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 version under a subject · Get schema by version #
Ask an LLM
“How do I fetch a specific version of a schema registered under a subject?”
“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 {subject}, including deleted versions.
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 is the difference between a soft 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} from subject {subject}, permanent={permanent}.
GET /subjects/{subject}/versions/{version}/referencedby List schemas that reference a schema version · List schemas referencing a schema #
Ask an LLM
“Which other schemas reference this schema version?”
“Is anything still depending on a schema version before I delete it?”
Tell an agent
List the schema IDs that reference version {version} of subject {subject}.
Show which schemas point to subject {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
“How do I get just the unescaped schema text for a subject version, without metadata?”
“Can I pull the raw schema definition for one version to paste into my code?”
Tell an agent
Get the raw schema string for subject {subject} version {version}.
Return only the schema text of version {version} under {subject}.
GET /subjects/{subject}/versions List versions registered under a subject · List versions under subject #
Ask an LLM
“What versions exist for a subject in Schema Registry?”
“Can I list only the soft-deleted versions of a subject?”
Tell an agent
List the versions of subject {subject}.
Show only deleted versions under subject {subject}, deletedOnly={deletedOnly}.
POST /subjects/{subject}/versions Register a new schema under a subject · Register schema under a subject #
Ask an LLM
“How do I register a new Avro or Protobuf schema under a subject?”
“Does registering a schema return its global schema ID?”
Tell an agent
Register this schema {schema} under subject {subject}.
Register a {schemaType} schema {schema} as a new version of {subject}.
POST /subjects/{subject} Check if a schema is already registered · Lookup schema under subject #
Ask an LLM
“Has this exact schema already been registered under my subject?”
“Can I find the version and ID of a schema I have in hand without registering it again?”
Tell an agent
Check whether schema {schema} is already registered under subject {subject}.
Look up the ID and version of schema {schema} in subject {subject}.
DELETE /subjects/{subject} Delete a subject and all its versions · Delete subject #
Ask an LLM
“How do I delete a whole subject from Schema Registry when recycling a topic?”
“Does deleting a subject also remove its compatibility setting?”
Tell an agent destructive · confirm first
Delete subject {subject}.
Permanently delete subject {subject} and every version, permanent={permanent}.
GET /subjects List subjects in Schema Registry · List subjects #
Ask an LLM
“What subjects are registered in my Schema Registry?”
“Can I list only subjects that start with a given prefix?”
Tell an agent
List all registered subjects.
List subjects starting with {subjectPrefix}.
GET /subjects/{subject}/metadata Get latest schema version matching metadata · Retrieve the latest version with the given metadata #
Ask an LLM
“Which is the newest schema version under a subject tagged with a given metadata key and value?”
“Can I find a schema version by its metadata instead of its version number?”
Tell an agent
Get the latest version of subject {subject} with metadata {key}={value}.
Find the newest schema in {subject} whose metadata {key} is {value}.
POST /subjects/{subject}/versions/{version}/tags Create or remove schema embedded tags for a subject version #

Documentation

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

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/confluent/refs/heads/main/openapi/confluent-subjects-v1-api-openapi.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:confluent-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-subjects-v1-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Confluent Subjects (v1) API
  x-refined-note:
  - x-api-id differs across the merged source definitions and was not carried
  - x-audience differs across the merged source definitions and was not carried
  - x-logo differs across the merged source definitions and was not carried
  version: '1.0'
  description: 'Operations tagged Subjects (v1) across 4 of this provider''s published API definitions: confluent-cloud-openapi.yaml, confluent-cloud-full.yaml, schema-registry-api-spec.yaml, schema-registry-openapi.yaml. Each path carries the servers of the definition it was published in.'
servers:
- url: https://api.confluent.cloud
  description: Confluent Cloud API
tags:


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