# 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'