Operations for managing schema groups in the Schema Registry.
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
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.curl "https://apis.io/api/v1/apis/microsoft-azure-event-hubs-schema-registry-api"curl "https://apis.io/api/v1/apis?limit=25"Discovery needs no key. Ratings and market analysis are Pro.
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.
A second provider on the same verified email joins the account you already have.
openapi: 3.2.0
info:
title: Azure Event Hubs Management REST Schema Registry API
description: Azure Resource Manager REST API for managing Event Hubs namespaces, event hubs, consumer groups, authorization rules, disaster recovery configurations, and schema registry groups. This API uses the Microsoft.EventHub resource provider and operates on the Azure management plane at management.azure.com.
version: '2024-01-01'
contact:
name: Microsoft Azure Support
url: https://azure.microsoft.com/en-us/support/
license:
name: Microsoft Azure Terms of Service
url: https://azure.microsoft.com/en-us/support/legal/
x-logo:
url: https://azure.microsoft.com/svghandler/event-hubs/
servers:
- url: https://management.azure.com
description: Azure Resource Manager
security:
- azure_auth:
- user_impersonation
tags:
- name: Schema Registry
description: Operations for managing schema groups in the Schema Registry.
paths:
? /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.EventHub/namespaces/{namespaceName}/schemagroups
: get:
operationId: SchemaRegistry_ListByNamespace
summary: Azure Event Hubs List schema groups
description: Gets all the Schema Groups in a Namespace.
tags:
- Schema Registry
parameters:
- $ref: '#/components/parameters/SubscriptionIdParameter'
- $ref: '#/components/parameters/ResourceGroupNameParameter'
- $ref: '#/components/parameters/NamespaceNameParameter'
- $ref: '#/components/parameters/ApiVersionParameter'
- name: $skip
in: query
schema:
type: integer
minimum: 0
maximum: 1000
- name: $top
in: query
schema:
type: integer
minimum: 1
maximum: 1000
responses:
'200':
description: Successfully retrieved the list of schema groups.
content:
application/json:
schema:
$ref: '#/components/schemas/SchemaGroupListResult'
default:
description: Event Hubs error response describing why the operation failed.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
? /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.EventHub/namespaces/{namespaceName}/schemagroups/{schemaGroupName}
: put:
operationId: SchemaRegistry_CreateOrUpdate
summary: Azure Event Hubs Create or update a schema group
description: Creates or Updates an EventHub schema group.
tags:
- Schema Registry
parameters:
- $ref: '#/components/parameters/SubscriptionIdParameter'
- $ref: '#/components/parameters/ResourceGroupNameParameter'
- $ref: '#/components/parameters/NamespaceNameParameter'
- name: schemaGroupName
in: path
required: true
description: The Schema Group name.
schema:
type: string
minLength: 1
maxLength: 256
- $ref: '#/components/parameters/ApiVersionParameter'
requestBody:
required: true
description: Parameters supplied to create an Event Hub schema group resource.
content:
application/json:
schema:
$ref: '#/components/schemas/SchemaGroup'
responses:
'200':
description: Schema group successfully created.
content:
application/json:
schema:
$ref: '#/components/schemas/SchemaGroup'
default:
description: Event Hubs error response describing why the operation failed.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
get:
operationId: SchemaRegistry_Get
summary: Azure Event Hubs Get a schema group
description: Gets the details of an EventHub schema group.
tags:
- Schema Registry
parameters:
- $ref: '#/components/parameters/SubscriptionIdParameter'
- $ref: '#/components/parameters/ResourceGroupNameParameter'
- $ref: '#/components/parameters/NamespaceNameParameter'
- name: schemaGroupName
in: path
required: true
description: The Schema Group name.
schema:
type: string
minLength: 1
maxLength: 256
- $ref: '#/components/parameters/ApiVersionParameter'
responses:
'200':
description: Successfully retrieved the schema group.
content:
application/json:
schema:
$ref: '#/components/schemas/SchemaGroup'
default:
description: Event Hubs error response describing why the operation failed.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
delete:
operationId: SchemaRegistry_Delete
summary: Azure Event Hubs Delete a schema group
description: Deletes an EventHub schema group.
tags:
- Schema Registry
parameters:
- $ref: '#/components/parameters/SubscriptionIdParameter'
- $ref: '#/components/parameters/ResourceGroupNameParameter'
- $ref: '#/components/parameters/NamespaceNameParameter'
- name: schemaGroupName
in: path
required: true
description: The Schema Group name.
schema:
type: string
minLength: 1
maxLength: 256
- $ref: '#/components/parameters/ApiVersionParameter'
responses:
'200':
description: Schema group deleted.
'204':
description: No content.
default:
description: Event Hubs error response describing why the operation failed.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
components:
schemas:
ErrorResponse:
type: object
description: Error response indicates Event Hub service is not able to process the incoming request. The reason is provided in the error message.
properties:
error:
$ref: '#/components/schemas/ErrorDetail'
SystemData:
type: object
description: Metadata pertaining to creation and last modification of the resource.
properties:
createdBy:
type: string
description: The identity that created the resource.
createdByType:
type: string
description: The type of identity that created the resource.
enum:
- User
- Application
- ManagedIdentity
- Key
createdAt:
type: string
format: date-time
description: The timestamp of resource creation (UTC).
lastModifiedBy:
type: string
description: The identity that last modified the resource.
lastModifiedByType:
type: string
description: The type of identity that last modified the resource.
enum:
- User
- Application
- ManagedIdentity
- Key
lastModifiedAt:
type: string
format: date-time
description: The timestamp of resource last modification (UTC).
SchemaGroupListResult:
type: object
description: The result of the List Schema Groups operation.
properties:
value:
type: array
items:
$ref: '#/components/schemas/SchemaGroup'
description: Result of the List Schema Groups operation.
nextLink:
type: string
description: Link to the next set of results.
ErrorDetail:
type: object
description: The error detail.
properties:
code:
type: string
readOnly: true
description: The error code.
message:
type: string
readOnly: true
description: The error message.
target:
type: string
readOnly: true
description: The error target.
details:
type: array
items:
$ref: '#/components/schemas/ErrorDetail'
readOnly: true
description: The error details.
additionalInfo:
type: array
items:
$ref: '#/components/schemas/ErrorAdditionalInfo'
readOnly: true
description: The error additional info.
ErrorAdditionalInfo:
type: object
description: The resource management error additional info.
properties:
type:
type: string
readOnly: true
description: The additional info type.
info:
type: object
readOnly: true
description: The additional info.
SchemaGroup:
type: object
description: Single item in List or Get Schema Group operation.
properties:
id:
type: string
readOnly: true
description: Fully qualified resource ID for the resource.
name:
type: string
readOnly: true
description: The name of the resource.
type:
type: string
readOnly: true
description: The type of the resource.
properties:
type: object
properties:
updatedAtUtc:
type: string
format: date-time
readOnly: true
description: Exact time the Schema Group was updated.
createdAtUtc:
type: string
format: date-time
readOnly: true
description: Exact time the Schema Group was created.
eTag:
type: string
format: uuid
readOnly: true
description: The ETag value.
groupProperties:
type: object
additionalProperties:
type: string
description: Dictionary object for SchemaGroup group properties.
schemaCompatibility:
type: string
description: Schema compatibility setting.
enum:
- None
- Backward
- Forward
schemaType:
type: string
description: Schema type.
enum:
- Unknown
- Avro
systemData:
$ref: '#/components/schemas/SystemData'
parameters:
SubscriptionIdParameter:
name: subscriptionId
in: path
required: true
description: Subscription credentials that uniquely identify a Microsoft Azure subscription. The subscription ID forms part of the URI for every service call.
schema:
type: string
ApiVersionParameter:
name: api-version
in: query
required: true
description: Client API version.
schema:
type: string
default: '2024-01-01'
NamespaceNameParameter:
name: namespaceName
in: path
required: true
description: The Namespace name.
schema:
type: string
minLength: 6
maxLength: 50
pattern: ^[a-zA-Z][a-zA-Z0-9-]{6,50}[a-zA-Z0-9]$
ResourceGroupNameParameter:
name: resourceGroupName
in: path
required: true
description: Name of the resource group within the Azure subscription.
schema:
type: string
minLength: 1
maxLength: 90
securitySchemes:
azure_auth:
type: oauth2
description: Azure Active Directory OAuth2 Flow.
flows:
implicit:
authorizationUrl: https://login.microsoftonline.com/common/oauth2/authorize
scopes:
user_impersonation: Impersonate your user account