v1

latestOpenAPI 3.0.2Apache 2.02026-07-174217115.5 KB
Subjects

Returns the schema string along with its global ID and version if already registered under the given subject.

post/subjects/{subject}

Path parameters

subjectstring required

The subject under which the schema will be registered.

Query parameters

normalizeboolean

Normalize the schema content before comparing. Default is false.

formatstring

Desired output format. For AVRO: "" or "resolved". For PROTOBUF: "", "ignore_extensions", or "serialized".

deletedboolean

Lookup for soft-deleted values.

Headers

X-Registry-GroupIdstring

Group id in Apicurio Registry.

Request body

schemastring required

The schema definition as a string.

schemaTypestring

The schema format (AVRO, PROTOBUF, JSON). Default is AVRO.

metadataobject

Optional metadata associated with the schema.

ruleSetobject

Optional ruleset configuration for the schema.

Response

Schema found under the subject.

subjectstring required

The name of the subject this schema belongs to.

versioninteger required

The version of the schema under the subject.

idinteger

The globally unique ID of the schema.

schemastring required

The actual schema definition as a string.

schemaTypestring

The type of the schema (AVRO, PROTOBUF, JSON). Default is AVRO.