# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Confluent Cloud Schemas (v1) API
  version: 1.0.0
extends: openapi/confluent-schemas-v1-api-openapi.yml
actions:
- target: $.info
  update:
    x-apievangelist-phrasing:
      method: generated
      generated: '2026-09-26'
      generator: build-phrasing.py
      label: Generated by API Evangelist
      operations: 6
- target: $.paths['/schemas/ids/{id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a schema string by ID
      effect: read
      questions:
      - How do I fetch the schema for a given schema ID in Schema Registry?
      - Can I get the schema by ID in a specific format?
      instructions:
      - text: Get schema {id} with its metadata.
        slots:
          id: path.id
      - text: Fetch schema ID {id} in format {format}.
        slots:
          id: path.id
          format: query.format
      method: generated
      generated: '2026-09-26'
- target: $.paths['/schemas/ids/{id}/schema'].get
  update:
    x-apievangelist-phrasing:
      intent: Get only the raw schema by ID
      effect: read
      questions:
      - Can I get just the raw schema text for an ID without the wrapper object?
      - What is the bare schema definition behind a schema ID?
      instructions:
      - text: Return only the raw schema body for ID {id}.
        slots:
          id: path.id
      - text: Give me the bare schema text for ID {id} under subject {subject}.
        slots:
          id: path.id
          subject: query.subject
      method: generated
      generated: '2026-09-26'
- target: $.paths['/schemas/types'].get
  update:
    x-apievangelist-phrasing:
      intent: List supported schema types
      effect: read
      questions:
      - Which schema formats does the registry support, like Avro, Protobuf or JSON Schema?
      - Does this Schema Registry accept Protobuf schemas?
      instructions:
      - text: List the schema types this registry supports.
      - text: Show which schema formats are available.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/schemas'].get
  update:
    x-apievangelist-phrasing:
      intent: Search schemas by subject prefix
      effect: read
      questions:
      - How do I find all schemas whose subject starts with a prefix?
      - Can I list only the latest schema versions?
      - Which schemas use a particular rule type?
      instructions:
      - text: List schemas with subject prefix {subjectPrefix}.
        slots:
          subjectPrefix: query.subjectPrefix
      - text: List only the latest schemas that have rule type {ruleType}.
        slots:
          ruleType: query.ruleType
      method: generated
      generated: '2026-09-26'
- target: $.paths['/schemas/ids/{id}/subjects'].get
  update:
    x-apievangelist-phrasing:
      intent: List subjects using a schema ID
      effect: read
      questions:
      - Which subjects reference a particular schema ID?
      - Can I include deleted subjects when checking where a schema ID is used?
      instructions:
      - text: List subjects associated with schema ID {id}.
        slots:
          id: path.id
      - text: Show every subject that uses schema {id}, including deleted ones.
        slots:
          id: path.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/schemas/ids/{id}/versions'].get
  update:
    x-apievangelist-phrasing:
      intent: List subject-version pairs for a schema ID
      effect: read
      questions:
      - What subject and version combinations point at one schema ID?
      - Can I see which version number a schema ID has in each subject?
      instructions:
      - text: List subject-version pairs for schema ID {id}.
        slots:
          id: path.id
      - text: Show the versions of schema {id} within subject {subject}.
        slots:
          id: path.id
          subject: query.subject
      method: generated
      generated: '2026-09-26'