# 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 Image Region Proposal API
  version: 1.0.0
extends: openapi/microsoft-azure-imageregionproposalapi-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: 2
- target: $.paths['/projects/{projectId}/images/{imageId}/regionproposals'].post
  update:
    x-apievangelist-phrasing:
      intent: Get region proposals for a training image
      effect: read
      questions:
      - How do I get suggested object regions for an image in my Custom Vision project?
      - Does the projects-path region proposal endpoint return confidences for each region?
      instructions:
      - text: Get region proposals for image {image} in project {project}.
        slots:
          image: path.imageId
          project: path.projectId
      - text: Suggest regions with confidences for image {image} via the /projects path of project {project}.
        slots:
          image: path.imageId
          project: path.projectId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/{projectId}/images/{imageId}/regionproposals'].post
  update:
    x-apievangelist-phrasing:
      intent: Get region proposals using a training key
      effect: read
      questions:
      - Which region proposal call takes a Training-Key header instead of the /projects path?
      - Can I get proposed regions for an image with the older training-key endpoint?
      instructions:
      - text: Get region proposals for image {image} in project {project} using training key {key}.
        slots:
          image: path.imageId
          project: path.projectId
          key: header.Training-Key
      - text: Use the Training-Key endpoint to propose regions for image {image} of {project}.
        slots:
          image: path.imageId
          project: path.projectId
      method: generated
      generated: '2026-09-26'