naftiko: 1.0.0-alpha2
info:
  label: Microsoft Azure Azure Schema Registry — $schemaGroups
  description: 'Microsoft Azure Azure Schema Registry — $schemaGroups. 6 operations. Lead operation: Microsoft Azure Get List
    Of Schema Groups. Self-contained Naftiko capability covering one Microsoft Azure business surface.'
  tags:
  - Microsoft Azure
  - $schemaGroups
  created: '2026-05-19'
  modified: '2026-05-19'
binds:
- namespace: env
  keys:
    MICROSOFT_AZURE_API_KEY: MICROSOFT_AZURE_API_KEY
capability:
  consumes:
  - type: http
    namespace: azure-schema-registry-schemagroups
    baseUri: ''
    description: Microsoft Azure Azure Schema Registry — $schemaGroups business capability. Self-contained, no shared references.
    resources:
    - name: $schemaGroups
      path: /$schemaGroups
      operations:
      - name: microsoftazurelistschemagroups
        method: GET
        description: Microsoft Azure Get List Of Schema Groups
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: $schemaGroups-$schemas-id
      path: /$schemaGroups/$schemas/{id}
      operations:
      - name: microsoftazuregetschemabyid
        method: GET
        description: Microsoft Azure Get A Registered Schema By Its Unique Id Reference
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: id
          in: path
          type: string
          description: Schema ID that uniquely identifies a schema in the registry namespace.
          required: true
    - name: $schemaGroups-groupName-schemas-schemaName
      path: /$schemaGroups/{groupName}/schemas/{schemaName}
      operations:
      - name: microsoftazureregisterschema
        method: PUT
        description: Microsoft Azure Register New Schema
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: groupName
          in: path
          type: string
          description: Name of schema group.
          required: true
        - name: schemaName
          in: path
          type: string
          description: Name of schema.
          required: true
        - name: schemaContent
          in: body
          type: string
          description: String representation (UTF-8) of the schema.
          required: true
    - name: $schemaGroups-groupName-schemas-schemaName-versions
      path: /$schemaGroups/{groupName}/schemas/{schemaName}/versions
      operations:
      - name: microsoftazurelistschemaversions
        method: GET
        description: Microsoft Azure List Schema Versions
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: groupName
          in: path
          type: string
          description: Name of schema group.
          required: true
        - name: schemaName
          in: path
          type: string
          description: Name of schema.
          required: true
    - name: $schemaGroups-groupName-schemas-schemaName-versions-schemaVersion
      path: /$schemaGroups/{groupName}/schemas/{schemaName}/versions/{schemaVersion}
      operations:
      - name: microsoftazuregetschemabyversion
        method: GET
        description: Microsoft Azure Get Specific Schema Versions
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: groupName
          in: path
          type: string
          description: Name of schema group.
          required: true
        - name: schemaName
          in: path
          type: string
          description: Name of schema.
          required: true
        - name: schemaVersion
          in: path
          type: integer
          description: Version number of specific schema.
          required: true
    - name: $schemaGroups-groupName-schemas-schemaName}:get-id
      path: /$schemaGroups/{groupName}/schemas/{schemaName}:get-id
      operations:
      - name: microsoftazuregetschemapropertiesbycontent
        method: POST
        description: Microsoft Azure Get Properties For Existing Schema
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: groupName
          in: path
          type: string
          description: Name of schema group.
          required: true
        - name: schemaName
          in: path
          type: string
          description: Name of schema.
          required: true
        - name: schemaContent
          in: body
          type: string
          description: String representation (UTF-8) of the schema.
          required: true
  exposes:
  - type: rest
    namespace: azure-schema-registry-schemagroups-rest
    port: 8080
    description: REST adapter for Microsoft Azure Azure Schema Registry — $schemaGroups. One Spectral-compliant resource per
      consumed operation, prefixed with /v1.
    resources:
    - path: /v1/schemagroups
      name: schemagroups
      description: REST surface for $schemaGroups.
      operations:
      - method: GET
        name: microsoftazurelistschemagroups
        description: Microsoft Azure Get List Of Schema Groups
        call: azure-schema-registry-schemagroups.microsoftazurelistschemagroups
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/schemagroups/schemas/{id}
      name: schemagroups-schemas-id
      description: REST surface for $schemaGroups-$schemas-id.
      operations:
      - method: GET
        name: microsoftazuregetschemabyid
        description: Microsoft Azure Get A Registered Schema By Its Unique Id Reference
        call: azure-schema-registry-schemagroups.microsoftazuregetschemabyid
        with:
          id: rest.id
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/schemagroups/{groupname}/schemas/{schemaname}
      name: schemagroups-groupname-schemas-schemaname
      description: REST surface for $schemaGroups-groupName-schemas-schemaName.
      operations:
      - method: PUT
        name: microsoftazureregisterschema
        description: Microsoft Azure Register New Schema
        call: azure-schema-registry-schemagroups.microsoftazureregisterschema
        with:
          groupName: rest.groupName
          schemaName: rest.schemaName
          schemaContent: rest.schemaContent
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/schemagroups/{groupname}/schemas/{schemaname}/versions
      name: schemagroups-groupname-schemas-schemaname-versions
      description: REST surface for $schemaGroups-groupName-schemas-schemaName-versions.
      operations:
      - method: GET
        name: microsoftazurelistschemaversions
        description: Microsoft Azure List Schema Versions
        call: azure-schema-registry-schemagroups.microsoftazurelistschemaversions
        with:
          groupName: rest.groupName
          schemaName: rest.schemaName
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/schemagroups/{groupname}/schemas/{schemaname}/versions/{schemaversion}
      name: schemagroups-groupname-schemas-schemaname-versions-schemaversion
      description: REST surface for $schemaGroups-groupName-schemas-schemaName-versions-schemaVersion.
      operations:
      - method: GET
        name: microsoftazuregetschemabyversion
        description: Microsoft Azure Get Specific Schema Versions
        call: azure-schema-registry-schemagroups.microsoftazuregetschemabyversion
        with:
          groupName: rest.groupName
          schemaName: rest.schemaName
          schemaVersion: rest.schemaVersion
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/schemagroups/{groupname}/schemas/schemaname-get-id
      name: schemagroups-groupname-schemas-schemaname-get-id
      description: REST surface for $schemaGroups-groupName-schemas-schemaName}:get-id.
      operations:
      - method: POST
        name: microsoftazuregetschemapropertiesbycontent
        description: Microsoft Azure Get Properties For Existing Schema
        call: azure-schema-registry-schemagroups.microsoftazuregetschemapropertiesbycontent
        with:
          groupName: rest.groupName
          schemaName: rest.schemaName
          schemaContent: rest.schemaContent
        outputParameters:
        - type: object
          mapping: $.
  - type: mcp
    namespace: azure-schema-registry-schemagroups-mcp
    port: 9090
    transport: http
    description: MCP adapter for Microsoft Azure Azure Schema Registry — $schemaGroups. One tool per consumed operation, routed
      inline through this capability's consumes block.
    tools:
    - name: microsoft-azure-get-list-schema
      description: Microsoft Azure Get List Of Schema Groups
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: azure-schema-registry-schemagroups.microsoftazurelistschemagroups
      outputParameters:
      - type: object
        mapping: $.
    - name: microsoft-azure-get-registered-schema
      description: Microsoft Azure Get A Registered Schema By Its Unique Id Reference
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: azure-schema-registry-schemagroups.microsoftazuregetschemabyid
      with:
        id: tools.id
      outputParameters:
      - type: object
        mapping: $.
    - name: microsoft-azure-register-new-schema
      description: Microsoft Azure Register New Schema
      hints:
        readOnly: false
        destructive: false
        idempotent: true
      call: azure-schema-registry-schemagroups.microsoftazureregisterschema
      with:
        groupName: tools.groupName
        schemaName: tools.schemaName
        schemaContent: tools.schemaContent
      outputParameters:
      - type: object
        mapping: $.
    - name: microsoft-azure-list-schema-versions
      description: Microsoft Azure List Schema Versions
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: azure-schema-registry-schemagroups.microsoftazurelistschemaversions
      with:
        groupName: tools.groupName
        schemaName: tools.schemaName
      outputParameters:
      - type: object
        mapping: $.
    - name: microsoft-azure-get-specific-schema
      description: Microsoft Azure Get Specific Schema Versions
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: azure-schema-registry-schemagroups.microsoftazuregetschemabyversion
      with:
        groupName: tools.groupName
        schemaName: tools.schemaName
        schemaVersion: tools.schemaVersion
      outputParameters:
      - type: object
        mapping: $.
    - name: microsoft-azure-get-properties-existing
      description: Microsoft Azure Get Properties For Existing Schema
      hints:
        readOnly: true
        destructive: false
        idempotent: false
      call: azure-schema-registry-schemagroups.microsoftazuregetschemapropertiesbycontent
      with:
        groupName: tools.groupName
        schemaName: tools.schemaName
        schemaContent: tools.schemaContent
      outputParameters:
      - type: object
        mapping: $.