# 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 Azure Digital Twins Import Jobs API
  version: 1.0.0
extends: openapi/microsoft-azure-import-jobs-api-openapi.yml
actions:
- target: $.info
  update:
    x-apievangelist-phrasing:
      method: generated
      generated: '2026-10-01'
      generator: build-phrasing.py
      label: Generated by API Evangelist
      operations: 5
- target: $.paths['/jobs/imports'].get
  update:
    x-apievangelist-phrasing:
      intent: List Digital Twins import jobs
      effect: read
      questions:
      - What bulk import jobs have been run on my Azure Digital Twins instance?
      - Can I page through import jobs a set number at a time?
      instructions:
      - text: List all import jobs on my Digital Twins instance using API version {api_version}.
        slots:
          api_version: query.api-version
      - text: Show import jobs, {max_items_per_page} per page.
        slots:
          max_items_per_page: header.max-items-per-page
      method: generated
      generated: '2026-10-01'
- target: $.paths['/jobs/imports/{id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a Digital Twins import job
      effect: read
      questions:
      - How do I check the status of one Digital Twins import job?
      - Has my bulk import job finished or failed?
      instructions:
      - text: Get import job {id}.
        slots:
          id: path.id
      - text: Show the status of Digital Twins import job {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/jobs/imports/{id}'].put
  update:
    x-apievangelist-phrasing:
      intent: Start a bulk import job into Digital Twins
      effect: write
      questions:
      - How do I bulk import models, twins and relationships from a blob file?
      - Is there a limit on how many import jobs I can have?
      instructions:
      - text: Create import job {id} from {inputBlobUri} writing output to {outputBlobUri}.
        slots:
          id: path.id
          inputBlobUri: requestBody.inputBlobUri
          outputBlobUri: requestBody.outputBlobUri
      - text: Start Digital Twins import {id} using input blob {inputBlobUri} and log blob {outputBlobUri}.
        slots:
          id: path.id
          inputBlobUri: requestBody.inputBlobUri
          outputBlobUri: requestBody.outputBlobUri
      method: generated
      generated: '2026-10-01'
- target: $.paths['/jobs/imports/{id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a Digital Twins import job
      effect: destructive
      questions:
      - How do I delete an old import job record from Digital Twins?
      - Can I remove an import job after it completes?
      instructions:
      - text: Delete import job {id}.
        slots:
          id: path.id
      - text: Remove Digital Twins import job {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/jobs/imports/{id}/cancel'].post
  update:
    x-apievangelist-phrasing:
      intent: Cancel a running Digital Twins import job
      effect: destructive
      questions:
      - How do I stop an import job that is still running?
      - Can I cancel a bulk import partway through?
      instructions:
      - text: Cancel import job {id}.
        slots:
          id: path.id
      - text: Stop the running Digital Twins import {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-10-01'