# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Kinde Management Property Categories API
  version: 1.0.0
extends: openapi/kinde-property-categories-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: 3
- target: $.paths['/api/v1/property_categories'].get
  update:
    x-apievangelist-phrasing:
      intent: List property categories
      effect: read
      questions:
      - Which property categories exist?
      - Can I list categories for user properties only?
      instructions:
      - text: List all property categories.
      - text: Show property categories in the {context} context.
        slots:
          context: query.context
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/property_categories'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a property category
      effect: write
      questions:
      - How do I create a category to group custom properties?
      - Can I make a category just for organization properties?
      instructions:
      - text: Create a property category {name} in the {context} context.
        slots:
          name: requestBody.name
          context: requestBody.context
      - text: Add category {name} for {context} properties.
        slots:
          name: requestBody.name
          context: requestBody.context
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/property_categories/{category_id}'].put
  update:
    x-apievangelist-phrasing:
      intent: Rename a property category
      effect: write
      questions:
      - Can I rename an existing property category?
      - How do I change a category's name?
      instructions:
      - text: Rename property category {category_id} to {name}.
        slots:
          category_id: path.category_id
          name: requestBody.name
      - text: Update category {category_id} with the name {name}.
        slots:
          category_id: path.category_id
          name: requestBody.name
      method: generated
      generated: '2026-09-26'