# 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 Sensor Partner Integrations API
  version: 1.0.0
extends: openapi/microsoft-azure-sensorpartnerintegrations-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: 6
- target: $.paths['/sensor-partners/{sensorPartnerId}/integrations'].get
  update:
    x-apievangelist-phrasing:
      intent: List a sensor partner's integrations
      effect: read
      questions:
      - Which integrations exist for one of my sensor partners?
      - Can I filter sensor partner integrations by party, status or creation date?
      - Is there a page size limit when listing partner integrations?
      instructions:
      - text: List integrations for sensor partner {partner}.
        slots:
          partner: path.sensorPartnerId
      - text: List integrations of sensor partner {partner} for party {party} with status {status}.
        slots:
          partner: path.sensorPartnerId
          party: query.partyIds
          status: query.statuses
      - text: List sensor partner {partner} integrations created after {min_created}, {page_size} per page.
        slots:
          partner: path.sensorPartnerId
          min_created: query.minCreatedDateTime
          page_size: query.maxPageSize
      method: generated
      generated: '2026-09-26'
- target: $.paths['/sensor-partners/{sensorPartnerId}/integrations/{integrationId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a sensor partner integration
      effect: read
      questions:
      - How do I look up one integration with a sensor partner?
      - What does a single partner integration record contain?
      instructions:
      - text: Get integration {integration} for sensor partner {partner}.
        slots:
          integration: path.integrationId
          partner: path.sensorPartnerId
      - text: Show me partner integration {integration} under {partner}.
        slots:
          integration: path.integrationId
          partner: path.sensorPartnerId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/sensor-partners/{sensorPartnerId}/integrations/{integrationId}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a sensor partner integration
      effect: destructive
      questions:
      - How do I remove an integration with a sensor partner?
      - Can I delete a partner integration model I no longer need?
      instructions:
      - text: Delete integration {integration} from sensor partner {partner}.
        slots:
          integration: path.integrationId
          partner: path.sensorPartnerId
      - text: Remove the {integration} partner integration under {partner}.
        slots:
          integration: path.integrationId
          partner: path.sensorPartnerId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/sensor-partners/{sensorPartnerId}/integrations/{integrationId}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Create or update a sensor partner integration
      effect: write
      questions:
      - Can I set up an integration between a party and a sensor partner?
      - Is it possible to change the name or description of an existing partner integration?
      instructions:
      - text: Create integration {integration} with sensor partner {partner} for party {party}.
        slots:
          integration: path.integrationId
          partner: path.sensorPartnerId
          party: requestBody.partyId
      - text: Update integration {integration} under {partner} with name {name} and description {description}.
        slots:
          integration: path.integrationId
          partner: path.sensorPartnerId
          name: requestBody.name
          description: requestBody.description
      method: generated
      generated: '2026-09-26'
- target: $.paths['/sensor-partners/{sensorPartnerId}/integrations/{integrationId}/:check-consent'].post
  update:
    x-apievangelist-phrasing:
      intent: Check consent for a partner integration
      effect: read
      questions:
      - Has consent been granted for this sensor partner integration yet?
      - What key do I need to check consent on a partner integration?
      instructions:
      - text: Check consent for integration {integration} with sensor partner {partner} using key {key}.
        slots:
          integration: path.integrationId
          partner: path.sensorPartnerId
          key: query.key
      - text: Verify consent status of {integration} under {partner} with key {key}.
        slots:
          integration: path.integrationId
          partner: path.sensorPartnerId
          key: query.key
      method: generated
      generated: '2026-09-26'
- target: $.paths['/sensor-partners/{sensorPartnerId}/integrations/{integrationId}/:generate-consent-link'].post
  update:
    x-apievangelist-phrasing:
      intent: Generate a consent link for a partner integration
      effect: write
      questions:
      - How do I get a consent link to send for a sensor partner integration?
      - Can I generate a fresh consent link for an integration?
      instructions:
      - text: Generate a consent link for integration {integration} with sensor partner {partner}.
        slots:
          integration: path.integrationId
          partner: path.sensorPartnerId
      - text: Create the partner consent URL for {integration} under {partner}.
        slots:
          integration: path.integrationId
          partner: path.sensorPartnerId
      method: generated
      generated: '2026-09-26'