# 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 Organizations API
  version: 1.0.0
extends: openapi/microsoft-azure-organizations-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: 12
- target: $.paths['/subscriptions/{subscriptionId}/providers/Astronomer.Astro/organizations'].get
  update:
    x-apievangelist-phrasing:
      intent: List Astro organizations in a subscription
      effect: read
      questions:
      - Which Astronomer Astro organizations are in my Azure subscription?
      - Can I see every Astro organization resource across the subscription?
      instructions:
      - text: List all Astro organizations in my subscription.
      - text: Show every Astronomer Astro organization resource I own.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Astronomer.Astro/organizations'].get
  update:
    x-apievangelist-phrasing:
      intent: List Astro organizations in a resource group
      effect: read
      questions:
      - What Astro organization resources sit in one resource group?
      - Is there a resource-group-scoped list of Astro organizations?
      instructions:
      - text: List Astro organizations in this resource group.
      - text: Show the Astronomer Astro organizations for one resource group.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Astronomer.Astro/organizations/{organizationName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get an Astro organization
      effect: read
      questions:
      - How do I read one Astro organization resource by name?
      - What properties does an Astronomer Astro organization resource carry?
      instructions:
      - text: Get Astro organization {organizationName}.
        slots:
          organizationName: path.organizationName
      - text: Show details of Astronomer Astro organization {organizationName}.
        slots:
          organizationName: path.organizationName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Astronomer.Astro/organizations/{organizationName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Create an Astro organization
      effect: write
      questions:
      - Can I create an Astronomer Astro organization from Azure?
      - What do I provide to create an Astro organization resource?
      instructions:
      - text: Create Astro organization {organizationName}.
        slots:
          organizationName: path.organizationName
      - text: Create Astronomer Astro organization {organizationName} with properties {properties}.
        slots:
          organizationName: path.organizationName
          properties: requestBody.properties
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Astronomer.Astro/organizations/{organizationName}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete an Astro organization
      effect: destructive
      questions:
      - How do I delete an Astro organization resource?
      - Can I tear down an Astronomer Astro organization I created in Azure?
      instructions:
      - text: Delete Astro organization {organizationName}.
        slots:
          organizationName: path.organizationName
      - text: Remove Astronomer Astro organization {organizationName}.
        slots:
          organizationName: path.organizationName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Astronomer.Astro/organizations/{organizationName}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update an Astro organization
      effect: write
      questions:
      - Can I update tags or identity on an existing Astro organization?
      - What fields are patchable on an Astronomer Astro organization?
      instructions:
      - text: Update Astro organization {organizationName} with tags {tags}.
        slots:
          organizationName: path.organizationName
          tags: requestBody.tags
      - text: Patch Astronomer Astro organization {organizationName}.
        slots:
          organizationName: path.organizationName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/organizations'].get
  update:
    x-apievangelist-phrasing:
      intent: List organizations in an application
      effect: read
      questions:
      - Which organizations can the current user access in my application?
      - How do I see the organization hierarchy set up in my application?
      instructions:
      - text: List the organizations I have access to in the application.
      - text: Show all organizations defined in my application.
      - text: List my application organizations with API version {api-version}.
        slots:
          api-version: query.api-version
      method: generated
      generated: '2026-09-26'
- target: $.paths['/organizations/{organizationId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get an application organization by ID
      effect: read
      questions:
      - How do I look up one organization in my application by ID?
      - What is the parent of a given organization in my application?
      instructions:
      - text: Get application organization {organizationId}.
        slots:
          organizationId: path.organizationId
      - text: Show the display name and parent of organization {organizationId}.
        slots:
          organizationId: path.organizationId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/organizations/{organizationId}'].put
  update:
    x-apievangelist-phrasing:
      intent: Create an organization in an application
      effect: write
      questions:
      - Can I create a child organization under a parent in my application?
      - What do I need to add a new organization to my application?
      instructions:
      - text: Create organization {organizationId} named {displayName}.
        slots:
          organizationId: path.organizationId
          displayName: requestBody.displayName
      - text: Create organization {organizationId} called {displayName} under parent {parent}.
        slots:
          organizationId: path.organizationId
          displayName: requestBody.displayName
          parent: requestBody.parent
      method: generated
      generated: '2026-09-26'
- target: $.paths['/organizations/{organizationId}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete an application organization
      effect: destructive
      questions:
      - How do I remove an organization from my application?
      - Can I delete an organization I no longer need in the app?
      instructions:
      - text: Delete application organization {organizationId}.
        slots:
          organizationId: path.organizationId
      - text: Remove organization {organizationId} from the application.
        slots:
          organizationId: path.organizationId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/organizations/{organizationId}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update an application organization
      effect: write
      questions:
      - Can I patch an existing organization in my application?
      - Does updating an application organization support If-Match?
      instructions:
      - text: Update application organization {organizationId}.
        slots:
          organizationId: path.organizationId
      - text: Patch organization {organizationId} in the application.
        slots:
          organizationId: path.organizationId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/providers/NewRelic.Observability/organizations'].get
  update:
    x-apievangelist-phrasing:
      intent: List New Relic organizations for a user
      effect: read
      questions:
      - Which New Relic organizations exist for a given user email and location?
      - Can I find existing New Relic Observability organizations before linking one?
      instructions:
      - text: List New Relic organizations for {userEmail} in {location}.
        slots:
          userEmail: query.userEmail
          location: query.location
      - text: Show the existing New Relic Observability organizations tied to {userEmail} in region {location}.
        slots:
          userEmail: query.userEmail
          location: query.location
      method: generated
      generated: '2026-09-26'