# 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 SaaS Subscription Level Saa S Resources API
  version: 1.0.0
extends: openapi/microsoft-azure-subscriptionlevelsaasresources-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: 10
- target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.SaaS/resources'].get
  update:
    x-apievangelist-phrasing:
      intent: List SaaS subscriptions in an Azure subscription
      effect: read
      questions:
      - Which marketplace SaaS subscriptions exist across my whole Azure subscription?
      - Can I see every subscription-level SaaS resource without picking a resource group?
      instructions:
      - text: List all SaaS resources in subscription {subscriptionId}.
        slots:
          subscriptionId: path.subscriptionId
      - text: Show every subscription-level SaaS purchase under {subscriptionId}.
        slots:
          subscriptionId: path.subscriptionId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.SaaS/resources'].get
  update:
    x-apievangelist-phrasing:
      intent: List SaaS subscriptions in a resource group
      effect: read
      questions:
      - What SaaS marketplace resources are in a specific resource group?
      - Can I filter my SaaS subscriptions down to one resource group?
      instructions:
      - text: List SaaS resources in resource group {resourceGroupName} of subscription {subscriptionId}.
        slots:
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
      - text: Show the SaaS subscriptions inside {resourceGroupName}, subscription {subscriptionId}.
        slots:
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.SaaS/resources/{resourceName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a SaaS subscription resource
      effect: read
      questions:
      - How do I see the details of one SaaS marketplace resource?
      - What status and plan does a given SaaS subscription have?
      instructions:
      - text: Get SaaS resource {resourceName} in {resourceGroupName}, subscription {subscriptionId}.
        slots:
          resourceName: path.resourceName
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
      - text: Show details for SaaS subscription {resourceName} in group {resourceGroupName} of {subscriptionId}.
        slots:
          resourceName: path.resourceName
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.SaaS/resources/{resourceName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Create or replace a SaaS subscription resource
      effect: write
      questions:
      - How do I purchase a SaaS offer as a subscription-level resource?
      - What location must a SaaS resource use when created?
      instructions:
      - text: Create SaaS resource {resourceName} in {resourceGroupName}, subscription {subscriptionId}, with properties {properties}.
        slots:
          resourceName: path.resourceName
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
          properties: requestBody.properties
      - text: Create or overwrite SaaS subscription {resourceName} in group {resourceGroupName} of {subscriptionId}.
        slots:
          resourceName: path.resourceName
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.SaaS/resources/{resourceName}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a SaaS subscription resource
      effect: destructive
      questions:
      - How do I delete a SaaS marketplace resource from a resource group?
      - Is deleting a SaaS resource different from unsubscribing?
      instructions:
      - text: Delete SaaS resource {resourceName} in {resourceGroupName}, subscription {subscriptionId}.
        slots:
          resourceName: path.resourceName
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
      - text: Remove the SaaS resource {resourceName} from group {resourceGroupName} in {subscriptionId}.
        slots:
          resourceName: path.resourceName
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.SaaS/resources/{resourceName}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update tags or properties on a SaaS resource
      effect: write
      questions:
      - Can I change the tags on an existing SaaS subscription?
      - How do I patch an existing SaaS resource's properties?
      instructions:
      - text: Update the tags on SaaS resource {resourceName} in {resourceGroupName}, subscription {subscriptionId}, to {tags}.
        slots:
          resourceName: path.resourceName
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
          tags: requestBody.tags
      - text: Patch existing SaaS subscription {resourceName} in {resourceGroupName} of {subscriptionId}.
        slots:
          resourceName: path.resourceName
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.SaaS/resources/{resourceName}/unsubscribe'].post
  update:
    x-apievangelist-phrasing:
      intent: Unsubscribe from a SaaS offer
      effect: destructive
      questions:
      - How do I cancel my subscription to a marketplace SaaS product?
      - Can I give a reason code and feedback when unsubscribing from a SaaS offer?
      instructions:
      - text: Unsubscribe SaaS resource {resourceName} in {resourceGroupName}, subscription {subscriptionId}.
        slots:
          resourceName: path.resourceName
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
      - text: Cancel SaaS {resourceName} in {resourceGroupName} of {subscriptionId} with feedback {feedback}.
        slots:
          resourceName: path.resourceName
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
          feedback: requestBody.feedback
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.SaaS/resources/{resourceName}/listAccessToken'].post
  update:
    x-apievangelist-phrasing:
      intent: Get the ISV access token for a SaaS resource
      effect: read
      questions:
      - How do I get the publisher's access token to configure my SaaS purchase?
      - Where do I retrieve the ISV token for a SaaS subscription?
      instructions:
      - text: Get the ISV access token for SaaS resource {resourceName} in {resourceGroupName}, subscription {subscriptionId}.
        slots:
          resourceName: path.resourceName
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
      - text: Fetch the publisher token for {resourceName} in group {resourceGroupName} of {subscriptionId}.
        slots:
          resourceName: path.resourceName
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/validateMoveResources'].post
  update:
    x-apievangelist-phrasing:
      intent: Check whether SaaS resources can be moved
      effect: read
      questions:
      - Can my SaaS resources be moved to another resource group before I try it?
      - How do I dry-run a move of SaaS subscriptions?
      instructions:
      - text: Validate moving SaaS resources from {resourceGroupName} in {subscriptionId} to {targetResourceGroup}.
        slots:
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
          targetResourceGroup: requestBody.targetResourceGroup
      - text: Check if {resources} can move out of group {resourceGroupName}, subscription {subscriptionId}.
        slots:
          resources: requestBody.resources
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/moveResources'].post
  update:
    x-apievangelist-phrasing:
      intent: Move SaaS resources to another resource group
      effect: write
      questions:
      - How do I actually move a SaaS subscription into a different resource group?
      - Can I move several SaaS resources in one go?
      instructions:
      - text: Move SaaS resources from {resourceGroupName} in {subscriptionId} to {targetResourceGroup}.
        slots:
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
          targetResourceGroup: requestBody.targetResourceGroup
      - text: Relocate {resources} from group {resourceGroupName}, subscription {subscriptionId}, now.
        slots:
          resources: requestBody.resources
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
      method: generated
      generated: '2026-09-26'