# 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 Saa S Resources API
  version: 1.0.0
extends: openapi/microsoft-azure-saasresources-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: 8
- target: $.paths['/providers/Microsoft.SaaS/operations'].get
  update:
    x-apievangelist-phrasing:
      intent: List Microsoft.SaaS provider operations
      effect: read
      questions:
      - What operations does the Microsoft.SaaS resource provider support?
      - Which actions can be permissioned on SaaS app resources?
      instructions:
      - text: List all Microsoft.SaaS operations with API version {api-version}.
        slots:
          api-version: query.api-version
      - text: Show the SaaS resource provider's supported operations.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.SaaS/applications'].get
  update:
    x-apievangelist-phrasing:
      intent: List SaaS applications in a resource group
      effect: read
      questions:
      - Which Marketplace SaaS applications are in one resource group?
      - How do I list SaaS apps by resource group?
      instructions:
      - text: List SaaS applications in resource group {resourceGroupName} of subscription {subscriptionId}.
        slots:
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
      - text: Show the SaaS apps deployed to {resourceGroupName}.
        slots:
          resourceGroupName: path.resourceGroupName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/providers/Microsoft.SaaS/saasresources/{resourceId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a SaaS resource
      effect: read
      questions:
      - How do I look up one Marketplace SaaS subscription resource?
      - What plan and status does a specific SaaS resource have?
      instructions:
      - text: Get SaaS resource {resourceId}.
        slots:
          resourceId: path.resourceId
      - text: Show details of SaaS subscription {resourceId}.
        slots:
          resourceId: path.resourceId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/providers/Microsoft.SaaS/saasresources/{resourceId}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete or unsubscribe a SaaS resource
      effect: destructive
      questions:
      - Can I just unsubscribe from a SaaS offer instead of deleting the resource?
      - How do I cancel a Marketplace SaaS resource and give a reason?
      instructions:
      - text: Delete SaaS resource {resourceId}.
        slots:
          resourceId: path.resourceId
      - text: Unsubscribe SaaS resource {resourceId} with reason code {reasonCode}.
        slots:
          resourceId: path.resourceId
          reasonCode: requestBody.reasonCode
      - text: Unsubscribe only ({unsubscribeOnly}) from {resourceId} with feedback {feedback}.
        slots:
          resourceId: path.resourceId
          unsubscribeOnly: requestBody.unsubscribeOnly
          feedback: requestBody.feedback
      method: generated
      generated: '2026-09-26'
- target: $.paths['/providers/Microsoft.SaaS/saasresources/{resourceId}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update a SaaS resource
      effect: write
      questions:
      - Can I change tags or properties on an existing SaaS resource?
      - How do I modify a Marketplace SaaS subscription after purchase?
      instructions:
      - text: Update SaaS resource {resourceId}.
        slots:
          resourceId: path.resourceId
      - text: Set tags {tags} on SaaS resource {resourceId}.
        slots:
          resourceId: path.resourceId
          tags: requestBody.tags
      method: generated
      generated: '2026-09-26'
- target: $.paths['/providers/Microsoft.SaaS/saasresources'].get
  update:
    x-apievangelist-phrasing:
      intent: List all SaaS resources
      effect: read
      questions:
      - What Marketplace SaaS resources do I own across everything?
      - Is there a way to get all SaaS resources in one call?
      instructions:
      - text: List all my SaaS resources with API version {api-version}.
        slots:
          api-version: query.api-version
      - text: Show every SaaS subscription resource I have.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/providers/Microsoft.SaaS/saasresources'].put
  update:
    x-apievangelist-phrasing:
      intent: Create a SaaS resource
      effect: write
      questions:
      - How do I purchase a Marketplace SaaS offer as a new resource?
      - What properties do I pass when creating a SaaS resource?
      instructions:
      - text: Create SaaS resource {name} in {location}.
        slots:
          name: requestBody.name
          location: requestBody.location
      - text: Create a SaaS resource with properties {properties}.
        slots:
          properties: requestBody.properties
      method: generated
      generated: '2026-09-26'
- target: $.paths['/providers/Microsoft.SaaS/saasresources/{resourceId}/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 (ISV) access token for a SaaS subscription?
      - Where does the token for landing on the ISV's SaaS page come from?
      instructions:
      - text: Get the ISV access token for SaaS resource {resourceId}.
        slots:
          resourceId: path.resourceId
      - text: Fetch the publisher token of {resourceId}.
        slots:
          resourceId: path.resourceId
      method: generated
      generated: '2026-09-26'