# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Microsoft Azure Microsoft.Confluent Organization API
  version: 1.0.0
extends: openapi/microsoft-azure-organization-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: 7
- target: $.paths['/providers/Microsoft.Confluent/operations'].get
  update:
    x-apievangelist-phrasing:
      intent: List operations offered by the Confluent provider
      effect: read
      questions:
      - What operations does the Microsoft.Confluent resource provider support?
      - Can I discover the available Confluent organization actions programmatically?
      instructions:
      - text: List every operation the Microsoft.Confluent provider exposes.
      - text: Show the supported Confluent resource provider actions for API version {apiVersion}.
        slots:
          apiVersion: query.api-version
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.Confluent/organizations'].get
  update:
    x-apievangelist-phrasing:
      intent: List Confluent organizations in a subscription
      effect: read
      questions:
      - Which Confluent organizations exist across my whole subscription?
      - How do I find every Confluent organization resource I own?
      instructions:
      - text: List all Confluent organizations in subscription {subscriptionId}.
        slots:
          subscriptionId: path.subscriptionId
      - text: Show every Confluent organization resource across subscription {subscriptionId}.
        slots:
          subscriptionId: path.subscriptionId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Confluent/organizations'].get
  update:
    x-apievangelist-phrasing:
      intent: List Confluent organizations in a resource group
      effect: read
      questions:
      - What Confluent organizations are in one resource group?
      - Can I scope the Confluent organization list to a single resource group?
      instructions:
      - text: List Confluent organizations in resource group {resourceGroupName}, subscription {subscriptionId}.
        slots:
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
      - text: Show the Confluent organizations inside {resourceGroupName}.
        slots:
          resourceGroupName: path.resourceGroupName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Confluent/organizations/{organizationName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a Confluent organization resource
      effect: read
      questions:
      - What are the properties of a specific Confluent organization?
      - Can I look up one Confluent organization by name?
      instructions:
      - text: Get Confluent organization {organizationName} in {resourceGroupName}, subscription {subscriptionId}.
        slots:
          organizationName: path.organizationName
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
      - text: Show details for Confluent organization {organizationName}.
        slots:
          organizationName: path.organizationName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Confluent/organizations/{organizationName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Create a Confluent organization resource
      effect: write
      questions:
      - How do I create a new Confluent organization in Azure?
      - Which properties are required to create a Confluent organization?
      instructions:
      - text: Create Confluent organization {organizationName} in {resourceGroupName}, subscription {subscriptionId}, with properties {properties}.
        slots:
          organizationName: path.organizationName
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
          properties: requestBody.properties
      - text: Set up Confluent organization {organizationName} in location {location} using {properties}.
        slots:
          organizationName: path.organizationName
          location: requestBody.location
          properties: requestBody.properties
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Confluent/organizations/{organizationName}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a Confluent organization resource
      effect: destructive
      questions:
      - Can I remove a Confluent organization resource from Azure?
      - What do I need to delete a Confluent organization?
      instructions:
      - text: Delete Confluent organization {organizationName} from {resourceGroupName}, subscription {subscriptionId}.
        slots:
          organizationName: path.organizationName
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
      - text: Remove the Confluent organization named {organizationName}.
        slots:
          organizationName: path.organizationName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Confluent/organizations/{organizationName}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update tags on a Confluent organization
      effect: write
      questions:
      - Can I change the tags on an existing Confluent organization?
      - What can be updated on a Confluent organization after it is created?
      instructions:
      - text: Set tags {tags} on Confluent organization {organizationName} in {resourceGroupName}, subscription {subscriptionId}.
        slots:
          tags: requestBody.tags
          organizationName: path.organizationName
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
      - text: Update the resource tags of Confluent organization {organizationName} to {tags}.
        slots:
          organizationName: path.organizationName
          tags: requestBody.tags
      method: generated
      generated: '2026-09-26'