API Evangelist conversational phrasing for Microsoft Azure Images API

# 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 Images API
  version: 1.0.0
extends: openapi/microsoft-azure-images-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: 13
- target: $.paths['/chat/threads/{chatThreadId}/images'].post
  update:
    x-apievangelist-phrasing:
      intent: Upload an image into a chat thread
      effect: write
      questions:
      - How do I share a picture inside a Communication Services chat thread on a user's behalf?
      - Can I set a filename when I upload an image to a chat thread?
      instructions:
      - text: Upload an image to chat thread {chatThreadId}.
        slots:
          chatThreadId: path.chatThreadId
      - text: Post the image file {filename} into chat thread {chatThreadId}.
        slots:
          filename: header.image-filename
          chatThreadId: path.chatThreadId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/chat/threads/{chatThreadId}/images/{imageId}/view/{imageViewType}'].get
  update:
    x-apievangelist-phrasing:
      intent: Download a chat thread image in a given view
      effect: read
      questions:
      - Can I fetch a chat image as a thumbnail instead of the original?
      - Which view types are available when I download an image from a chat thread?
      instructions:
      - text: Get image {imageId} from chat thread {chatThreadId} as the {imageViewType} view.
        slots:
          imageId: path.imageId
          chatThreadId: path.chatThreadId
          imageViewType: path.imageViewType
      - text: Download the {imageViewType} version of chat image {imageId}.
        slots:
          imageViewType: path.imageViewType
          imageId: path.imageId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/chat/threads/{chatThreadId}/images/{imageId}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete an image from a chat thread
      effect: destructive
      questions:
      - How can I remove a picture someone uploaded to a chat thread?
      - Is deleting a chat thread image permanent?
      instructions:
      - text: Delete image {imageId} from chat thread {chatThreadId}.
        slots:
          imageId: path.imageId
          chatThreadId: path.chatThreadId
      - text: Remove the uploaded chat image {imageId}.
        slots:
          imageId: path.imageId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/images/generations:submit'].post
  update:
    x-apievangelist-phrasing:
      intent: Submit a batch image generation job from a caption
      effect: write
      questions:
      - How do I generate several images from one text caption as a long-running job?
      - Can I choose the size and number of images in a submitted generation batch?
      instructions:
      - text: Submit an image generation job for the caption {prompt}.
        slots:
          prompt: requestBody.prompt
      - text: Queue {n} images of size {size} generated from {prompt}.
        slots:
          n: requestBody.n
          size: requestBody.size
          prompt: requestBody.prompt
      method: generated
      generated: '2026-09-26'
- target: $.paths['/operations/images/{operation-id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Check the status of an image generation operation
      effect: read
      questions:
      - Is my submitted image generation batch finished yet?
      - Where do I pick up the generated images once the operation succeeds?
      instructions:
      - text: Check the status of image operation {operation_id}.
        slots:
          operation_id: path.operation-id
      - text: Fetch the results of image generation operation {operation_id}.
        slots:
          operation_id: path.operation-id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/operations/images/{operation-id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a finished image operation and its images
      effect: destructive
      questions:
      - Can I purge a completed image generation job and every image it produced?
      - What happens if I try to delete an image operation that is still running?
      instructions:
      - text: Delete image operation {operation_id} and all its generated images.
        slots:
          operation_id: path.operation-id
      - text: Clean up the terminal image job {operation_id}.
        slots:
          operation_id: path.operation-id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/deployments/{deployment-id}/images/generations'].post
  update:
    x-apievangelist-phrasing:
      intent: Generate an image with a DALL-E deployment
      effect: write
      questions:
      - How do I create an image from a prompt using my DALL-E model deployment in Azure OpenAI?
      - Can I ask for HD quality or a vivid style when generating a DALL-E image?
      - Can DALL-E return the image as base64 instead of a URL?
      instructions:
      - text: Generate an image of {prompt} using deployment {deployment_id}.
        slots:
          prompt: requestBody.prompt
          deployment_id: path.deployment-id
      - text: Create a {size} {quality} image in {style} style from {prompt} on DALL-E deployment {deployment_id}.
        slots:
          size: requestBody.size
          quality: requestBody.quality
          style: requestBody.style
          prompt: requestBody.prompt
          deployment_id: path.deployment-id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AzureSphere/catalogs/{catalogName}/images'].get
  update:
    x-apievangelist-phrasing:
      intent: List images in an Azure Sphere catalog
      effect: read
      questions:
      - Which images have been uploaded to my Azure Sphere catalog?
      - Can I page through or filter the images in an Azure Sphere catalog?
      instructions:
      - text: List the images in Azure Sphere catalog {catalogName}.
        slots:
          catalogName: path.catalogName
      - text: Show the first {top} images in catalog {catalogName} matching {filter}.
        slots:
          top: query.$top
          catalogName: path.catalogName
          filter: query.$filter
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AzureSphere/catalogs/{catalogName}/images/{imageName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get an Azure Sphere catalog image
      effect: read
      questions:
      - How do I look up one specific image in an Azure Sphere catalog?
      - What properties does a single Azure Sphere image resource have?
      instructions:
      - text: Get image {imageName} from Azure Sphere catalog {catalogName}.
        slots:
          imageName: path.imageName
          catalogName: path.catalogName
      - text: Show the details of Sphere image {imageName}.
        slots:
          imageName: path.imageName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AzureSphere/catalogs/{catalogName}/images/{imageName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Create an image in an Azure Sphere catalog
      effect: write
      questions:
      - How do I add a new image to an Azure Sphere catalog?
      - Can I overwrite an existing Azure Sphere image resource by name?
      instructions:
      - text: Create image {imageName} in Azure Sphere catalog {catalogName}.
        slots:
          imageName: path.imageName
          catalogName: path.catalogName
      - text: Upload Sphere image {imageName} to catalog {catalogName} with properties {properties}.
        slots:
          imageName: path.imageName
          catalogName: path.catalogName
          properties: requestBody.properties
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AzureSphere/catalogs/{catalogName}/images/{imageName}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete an image from an Azure Sphere catalog
      effect: destructive
      questions:
      - Can I remove an old image from my Azure Sphere catalog?
      - What happens to devices when I delete a Sphere catalog image?
      instructions:
      - text: Delete image {imageName} from Azure Sphere catalog {catalogName}.
        slots:
          imageName: path.imageName
          catalogName: path.catalogName
      - text: Remove Sphere image {imageName} from the catalog.
        slots:
          imageName: path.imageName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.CustomerInsights/hubs/{hubName}/images/getEntityTypeImageUploadUrl'].post
  update:
    x-apievangelist-phrasing:
      intent: Get an upload URL for a profile or interaction image
      effect: read
      questions:
      - Where do I upload an image for a profile or interaction type in Customer Insights?
      - Can I get an image upload URL for a specific entity type name?
      instructions:
      - text: Get an entity type image upload URL for {entityTypeName} in hub {hubName}, resource group {resourceGroupName}, subscription {subscriptionId}.
        slots:
          entityTypeName: requestBody.entityTypeName
          hubName: path.hubName
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
      - text: Give me the upload URL for the {entityType} image of type {entityTypeName} in hub {hubName}.
        slots:
          entityType: requestBody.entityType
          entityTypeName: requestBody.entityTypeName
          hubName: path.hubName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.CustomerInsights/hubs/{hubName}/images/getDataImageUploadUrl'].post
  update:
    x-apievangelist-phrasing:
      intent: Get an upload URL for a Customer Insights data image
      effect: read
      questions:
      - How can I get a URL to upload a data image to my Customer Insights hub?
      - Can I set the relative path of a data image before uploading it?
      instructions:
      - text: Get a data image upload URL for hub {hubName} in {resourceGroupName}, subscription {subscriptionId}.
        slots:
          hubName: path.hubName
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
      - text: Give me a data image upload URL at relative path {relativePath} in hub {hubName}.
        slots:
          relativePath: requestBody.relativePath
          hubName: path.hubName
      method: generated
      generated: '2026-09-26'