Microsoft Azure

Microsoft Azure Microsoft Cognitive Language Service Analyze Conversations Authoring

Microsoft Azure Cognitive Services - Language Service Analyze Conversations Authoring helps developers understand and analyze text-based conversations. By leveraging advanced natural language processing technology, this service can extract valuable insights, sentiments, and intentions from long-form text conversations. It can also identify key topics, entities, and relationships within the text, helping users gain a deeper understanding of their conversations.

GitHub OpenAPI

Documentation

📖
Documentation
https://learn.microsoft.com/en-us/dotnet/api/overview/azure/ai.language.conversations-readme?view=azure-dotnet

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/microsoft-azure/refs/heads/main/openapimicrosoft-cognitive-language-service-analyze-conversations-authoring-openapi-original.yml

OpenAPI Specification

microsoft-cognitive-language-service-analyze-conversations-authoring-openapi-original.yml Raw ↑ 
swagger: '2.0'
info:
  title: Microsoft Azure Microsoft Cognitive Language Service - Analyze Conversations Authoring
  version: 2023-04-15-preview
  description: >-
    The language service API is a suite of natural language processing (NLP)
    skills built with best-in-class Microsoft machine learning algorithms. The
    API can be used to analyze unstructured text for tasks such as sentiment
    analysis, key phrase extraction, language detection and question answering.
    Further documentation can be found in <a
    href="https://docs.microsoft.com/en-us/azure/cognitive-services/language-service/overview">https://docs.microsoft.com/en-us/azure/cognitive-services/language-service/overview</a>.
securityDefinitions:
  AADToken:
    type: oauth2
    authorizationUrl: https://login.microsoftonline.com/common/oauth2/authorize
    flow: implicit
    description: >-
      These are the [Azure Active Directory
      OAuth2](https://docs.microsoft.com/azure/active-directory/develop/v1-overview)
      Flows. When paired with [Azure role-based
      access](https://docs.microsoft.com/azure/role-based-access-control/overview)
      control it can be used to control access to Azure Maps REST APIs. Azure
      role-based access controls are used to designate access to one or more
      Azure Maps resource account or sub-resources. Any user, group, or service
      principal can be granted access via a  built-in role or a custom role
      composed of one or more permissions to Azure Maps REST APIs.


      To implement scenarios, we recommend viewing [authentication
      concepts](https://aka.ms/amauth). In summary, this security definition
      provides a solution for modeling application(s) via objects capable of
      access control on specific APIs and scopes.


      #### Notes

      * This security definition **requires** the use of the `x-ms-client-id`
      header to indicate which Azure Maps resource the application is requesting
      access to. This can be acquired from the [Maps management
      API](https://aka.ms/amauthdetails).

      * 

      The `Authorization URL` is specific to the Azure public cloud instance.
      Sovereign clouds have unique Authorization URLs and Azure Active directory
      configurations. 

      * 

      The Azure role-based access control is configured from the [Azure
      management plane](https://aka.ms/amrbac) via Azure portal, PowerShell,
      CLI, Azure SDKs, or REST APIs.

      * 

      Usage of the [Azure Maps Web SDK](https://aka.ms/amaadmc) allows for
      configuration based setup of an application for multiple use cases.

      * Currently, Azure Active Directory [v1.0 or
      v2.0](https://docs.microsoft.com/azure/active-directory/develop/azure-ad-endpoint-comparison)
      supports Work, School, and Guests but does not support Personal accounts.
    scopes:
      https://cognitiveservices.azure.com/.default: https://cognitiveservices.azure.com/.default
  apim_key:
    type: apiKey
    description: A subscription key for a Language service resource.
    name: Ocp-Apim-Subscription-Key
    in: header
security:
  - AADToken:
      - https://cognitiveservices.azure.com/.default
  - apim_key: []
x-ms-parameterized-host:
  hostTemplate: '{Endpoint}/language'
  useSchemePrefix: false
  parameters:
    - $ref: common.json#/parameters/Endpoint
paths:
  /authoring/analyze-conversations/projects:
    get:
      description: Lists the existing projects.
      operationId: microsoftAzureConversationalanalysisauthoringListprojects
      produces:
        - application/json
      parameters:
        - $ref: common.json#/parameters/TopParameter
        - $ref: common.json#/parameters/SkipParameter
        - $ref: common.json#/parameters/MaxPageSizeParameter
        - $ref: common.json#/parameters/ApiVersionParameter
      responses:
        '200':
          description: The metadata of projects.
          schema:
            $ref: '#/definitions/ConversationalAnalysisAuthoringProjectsMetadata'
        default:
          description: Error response.
          schema:
            $ref: common.json#/definitions/ErrorResponse
      x-ms-examples:
        Successful List Projects:
          $ref: >-
            ./examples/analyzeconversations-authoring/SuccessfulListProjects.json
      x-ms-pageable:
        nextLinkName: nextLink
        itemName: value
      summary: Microsoft Azure Get Authoring Analyze Conversations Projects
      tags:
        - Authoring
  /authoring/analyze-conversations/projects/{projectName}:
    patch:
      description: Creates a new project or updates an existing one.
      operationId: microsoftAzureConversationalanalysisauthoringCreateproject
      consumes:
        - application/merge-patch+json
      produces:
        - application/json
      parameters:
        - $ref: common.json#/parameters/ProjectNamePathParameter
        - in: body
          name: body
          description: The project parameters.
          required: true
          schema:
            $ref: '#/definitions/ConversationalAnalysisAuthoringCreateProjectOptions'
        - $ref: common.json#/parameters/ApiVersionParameter
      responses:
        '200':
          description: The metadata of the updated project, if it already exists.
          schema:
            $ref: '#/definitions/ConversationalAnalysisAuthoringProjectMetadata'
        '201':
          description: The metadata of the created project.
          schema:
            $ref: '#/definitions/ConversationalAnalysisAuthoringProjectMetadata'
        default:
          description: Error response.
          schema:
            $ref: common.json#/definitions/ErrorResponse
      x-ms-examples:
        Successful Create Project:
          $ref: >-
            ./examples/analyzeconversations-authoring/SuccessfulCreateProject.json
      summary: Microsoft Azure Patch Authoring Analyze Conversations Projects Projectname
      tags:
        - Authoring
    get:
      description: Gets the details of a project.
      operationId: microsoftAzureConversationalanalysisauthoringGetproject
      produces:
        - application/json
      parameters:
        - $ref: common.json#/parameters/ProjectNamePathParameter
        - $ref: common.json#/parameters/ApiVersionParameter
      responses:
        '200':
          description: The metadata of the project.
          schema:
            $ref: '#/definitions/ConversationalAnalysisAuthoringProjectMetadata'
        default:
          description: Error response.
          schema:
            $ref: common.json#/definitions/ErrorResponse
      x-ms-examples:
        Successful Get Project:
          $ref: ./examples/analyzeconversations-authoring/SuccessfulGetProject.json
      summary: Microsoft Azure Get Authoring Analyze Conversations Projects Projectname
      tags:
        - Authoring
    delete:
      description: Deletes a project.
      operationId: microsoftAzureConversationalanalysisauthoringDeleteproject
      produces:
        - application/json
      parameters:
        - $ref: common.json#/parameters/ProjectNamePathParameter
        - $ref: common.json#/parameters/ApiVersionParameter
      responses:
        '202':
          description: >-
            A successful call results with an Operation-Location header used to
            check the status of the job.
          headers:
            operation-location:
              description: The location of the status API for monitoring the created job.
              type: string
        default:
          description: Error response.
          schema:
            $ref: common.json#/definitions/ErrorResponse
      x-ms-examples:
        Successful Delete Project:
          $ref: >-
            ./examples/analyzeconversations-authoring/SuccessfulDeleteProject.json
      x-ms-long-running-operation: true
      summary: Microsoft Azure Delete Authoring Analyze Conversations Projects Projectname
      tags:
        - Authoring
  /authoring/analyze-conversations/projects/{projectName}/:authorize-copy:
    post:
      description: >-
        Generates a copy project operation authorization to the current target
        Azure resource.
      operationId: microsoftAzureConversationalanalysisauthoringCopyprojectauthorization
      consumes:
        - application/json
      produces:
        - application/json
      parameters:
        - $ref: common.json#/parameters/ProjectNamePathParameter
        - in: body
          name: body
          description: The copy project authorization info.
          required: true
          schema:
            $ref: >-
              #/definitions/ConversationalAnalysisAuthoringCopyAuthorizationOptions
        - $ref: common.json#/parameters/ApiVersionParameter
      responses:
        '200':
          description: Payload to send to source resource to initiate project copying.
          schema:
            $ref: '#/definitions/ConversationalAnalysisAuthoringCopyProjectOptions'
        default:
          description: Error response.
          schema:
            $ref: common.json#/definitions/ErrorResponse
      x-ms-examples:
        Successful Copy Project Authorization:
          $ref: >-
            ./examples/analyzeconversations-authoring/SuccessfulCopyProjectAuthorization.json
      summary: >-
        Microsoft Azure Post Authoring Analyze Conversations Projects Projectname :authorize Copy
      tags:
        - Authoring
  /authoring/analyze-conversations/projects/{projectName}/:copy:
    post:
      description: Copies an existing project to another Azure resource.
      operationId: microsoftAzureConversationalanalysisauthoringCopyproject
      consumes:
        - application/json
      produces:
        - application/json
      parameters:
        - $ref: common.json#/parameters/ProjectNamePathParameter
        - in: body
          name: body
          description: The copy project info.
          required: true
          schema:
            $ref: '#/definitions/ConversationalAnalysisAuthoringCopyProjectOptions'
        - $ref: common.json#/parameters/ApiVersionParameter
      responses:
        '202':
          description: >-
            A successful call results with an Operation-Location header used to
            check the status of the job.
          headers:
            operation-location:
              description: The location of the status API for monitoring the created job.
              type: string
        default:
          description: Error response.
          schema:
            $ref: common.json#/definitions/ErrorResponse
      x-ms-examples:
        Successful Copy Project:
          $ref: ./examples/analyzeconversations-authoring/SuccessfulCopyProject.json
      x-ms-long-running-operation: true
      summary: Microsoft Azure Post Authoring Analyze Conversations Projects Projectname :copy
      tags:
        - Authoring
  /authoring/analyze-conversations/projects/{projectName}/:export:
    post:
      description: Triggers a job to export a project's data.
      operationId: microsoftAzureConversationalanalysisauthoringExport
      produces:
        - application/json
      parameters:
        - $ref: common.json#/parameters/ProjectNamePathParameter
        - $ref: >-
            #/parameters/ConversationalAnalysisAuthoringFormatQueryOptionalParameter
        - $ref: >-
            #/parameters/ConversationalAnalysisAuthoringStringIndexTypeQueryParameter
        - in: query
          name: assetKind
          description: Kind of asset to export.
          type: string
          x-ms-parameter-location: method
        - in: query
          name: trainedModelLabel
          description: >-
            Trained model label to export. If the trainedModelLabel is null, the
            default behavior is to export the current working copy.
          type: string
          x-ms-parameter-location: method
        - $ref: common.json#/parameters/ApiVersionParameter
      responses:
        '202':
          description: >-
            A successful call results with an Operation-Location header used to
            check the status of the job.
          headers:
            operation-location:
              description: The location of the status API for monitoring the created job.
              type: string
        default:
          description: Error response.
          schema:
            $ref: common.json#/definitions/ErrorResponse
      x-ms-examples:
        Successful Export Project:
          $ref: >-
            ./examples/analyzeconversations-authoring/SuccessfulExportProject.json
      x-ms-long-running-operation: true
      summary: Microsoft Azure Post Authoring Analyze Conversations Projects Projectname :export
      tags:
        - Authoring
  /authoring/analyze-conversations/projects/{projectName}/:import:
    post:
      description: >-
        Triggers a job to import a project. If a project with the same name
        already exists, the data of that project is replaced.
      operationId: microsoftAzureConversationalanalysisauthoringImport
      consumes:
        - application/json
      produces:
        - application/json
      parameters:
        - $ref: common.json#/parameters/ProjectNamePathParameter
        - $ref: >-
            #/parameters/ConversationalAnalysisAuthoringFormatQueryOptionalParameter
        - in: body
          name: body
          description: The project data to import.
          required: true
          schema:
            $ref: '#/definitions/ConversationalAnalysisAuthoringExportedProject'
        - $ref: common.json#/parameters/ApiVersionParameter
      responses:
        '202':
          description: >-
            A successful call results with an Operation-Location header used to
            check the status of the job.
          headers:
            operation-location:
              description: The location of the status API for monitoring the created job.
              type: string
        default:
          description: Error response.
          schema:
            $ref: common.json#/definitions/ErrorResponse
      x-ms-examples:
        Successful Import Project:
          $ref: >-
            ./examples/analyzeconversations-authoring/SuccessfulImportProject.json
      x-ms-long-running-operation: true
      summary: Microsoft Azure Post Authoring Analyze Conversations Projects Projectname :import
      tags:
        - Authoring
  /authoring/analyze-conversations/projects/{projectName}/:train:
    post:
      description: Triggers a training job for a project.
      operationId: microsoftAzureConversationalanalysisauthoringTrain
      consumes:
        - application/json
      produces:
        - application/json
      parameters:
        - $ref: common.json#/parameters/ProjectNamePathParameter
        - in: body
          name: body
          description: The training input parameters.
          required: true
          schema:
            $ref: '#/definitions/ConversationalAnalysisAuthoringTrainingJobOptions'
        - $ref: common.json#/parameters/ApiVersionParameter
      responses:
        '202':
          description: >-
            A successful call results with an Operation-Location header used to
            check the status of the job.
          headers:
            operation-location:
              description: The location of the status API for monitoring the created job.
              type: string
        default:
          description: Error response.
          schema:
            $ref: common.json#/definitions/ErrorResponse
      x-ms-examples:
        Successful Train Project:
          $ref: >-
            ./examples/analyzeconversations-authoring/SuccessfulTrainProject.json
      x-ms-long-running-operation: true
      summary: Microsoft Azure Post Authoring Analyze Conversations Projects Projectname :train
      tags:
        - Authoring
  /authoring/analyze-conversations/projects/{projectName}/copy/jobs/{jobId}:
    get:
      description: Gets the status of an existing copy project job.
      operationId: microsoftAzureConversationalanalysisauthoringGetcopyprojectstatus
      produces:
        - application/json
      parameters:
        - $ref: common.json#/parameters/ProjectNamePathParameter
        - $ref: '#/parameters/ConversationalAnalysisAuthoringJobIdPathParameter'
        - $ref: common.json#/parameters/ApiVersionParameter
      responses:
        '200':
          description: The status of the long running operation.
          schema:
            $ref: '#/definitions/ConversationalAnalysisAuthoringCopyProjectJobState'
        default:
          description: Error response.
          schema:
            $ref: common.json#/definitions/ErrorResponse
      x-ms-examples:
        Successful Get Copy Project Status:
          $ref: >-
            ./examples/analyzeconversations-authoring/SuccessfulGetCopyProjectStatus.json
      summary: Microsoft Azure Get Authoring Analyze Conversations Projects Projectname Copy Jobs Jobid
      tags:
        - Authoring
  /authoring/analyze-conversations/projects/{projectName}/deployments:
    get:
      description: Lists the deployments belonging to a project.
      operationId: microsoftAzureConversationalanalysisauthoringListdeployments
      produces:
        - application/json
      parameters:
        - $ref: common.json#/parameters/ProjectNamePathParameter
        - $ref: common.json#/parameters/TopParameter
        - $ref: common.json#/parameters/SkipParameter
        - $ref: common.json#/parameters/MaxPageSizeParameter
        - $ref: common.json#/parameters/ApiVersionParameter
      responses:
        '200':
          description: List of all deployments.
          schema:
            $ref: '#/definitions/ConversationalAnalysisAuthoringProjectDeployments'
        default:
          description: Error response.
          schema:
            $ref: common.json#/definitions/ErrorResponse
      x-ms-examples:
        Successful List Deployments:
          $ref: >-
            ./examples/analyzeconversations-authoring/SuccessfulListDeployments.json
      x-ms-pageable:
        nextLinkName: nextLink
        itemName: value
      summary: Microsoft Azure Get Authoring Analyze Conversations Projects Projectname Deployments
      tags:
        - Authoring
  /authoring/analyze-conversations/projects/{projectName}/deployments/:swap:
    post:
      description: Swaps two existing deployments with each other.
      operationId: microsoftAzureConversationalanalysisauthoringSwapdeployments
      consumes:
        - application/json
      produces:
        - application/json
      parameters:
        - $ref: common.json#/parameters/ProjectNamePathParameter
        - in: body
          name: body
          description: The job object to swap two deployments.
          required: true
          schema:
            $ref: >-
              #/definitions/ConversationalAnalysisAuthoringSwapDeploymentsOptions
        - $ref: common.json#/parameters/ApiVersionParameter
      responses:
        '202':
          description: >-
            A successful call results with an Operation-Location header used to
            check the status of the job.
          headers:
            operation-location:
              description: The location of the status API for monitoring the created job.
              type: string
        default:
          description: Error response.
          schema:
            $ref: common.json#/definitions/ErrorResponse
      x-ms-examples:
        Successful Swap Deployments:
          $ref: >-
            ./examples/analyzeconversations-authoring/SuccessfulSwapDeployments.json
      x-ms-long-running-operation: true
      summary: >-
        Microsoft Azure Post Authoring Analyze Conversations Projects Projectname Deployments :swap
      tags:
        - Authoring
  /authoring/analyze-conversations/projects/{projectName}/deployments/{deploymentName}:
    get:
      description: Gets the details of a deployment.
      operationId: microsoftAzureConversationalanalysisauthoringGetdeployment
      produces:
        - application/json
      parameters:
        - $ref: common.json#/parameters/ProjectNamePathParameter
        - $ref: common.json#/parameters/DeploymentNamePathParameter
        - $ref: common.json#/parameters/ApiVersionParameter
      responses:
        '200':
          description: The Deployment info.
          schema:
            $ref: '#/definitions/ConversationalAnalysisAuthoringProjectDeployment'
        default:
          description: Error response.
          schema:
            $ref: common.json#/definitions/ErrorResponse
      x-ms-examples:
        Successful Get Deployment:
          $ref: >-
            ./examples/analyzeconversations-authoring/SuccessfulGetDeployment.json
      summary: >-
        Microsoft Azure Get Authoring Analyze Conversations Projects Projectname Deployments Deploymentname
      tags:
        - Authoring
    put:
      description: Creates a new deployment or replaces an existing one.
      operationId: microsoftAzureConversationalanalysisauthoringDeployproject
      consumes:
        - application/json
      produces:
        - application/json
      parameters:
        - $ref: common.json#/parameters/ProjectNamePathParameter
        - $ref: common.json#/parameters/DeploymentNamePathParameter
        - in: body
          name: body
          description: The new deployment info.
          required: true
          schema:
            $ref: >-
              #/definitions/ConversationalAnalysisAuthoringCreateDeploymentOptions
        - $ref: common.json#/parameters/ApiVersionParameter
      responses:
        '202':
          description: >-
            A successful call results with an Operation-Location header used to
            check the status of the job.
          headers:
            operation-location:
              description: The location of the status API for monitoring the created job.
              type: string
        default:
          description: Error response.
          schema:
            $ref: common.json#/definitions/ErrorResponse
      x-ms-examples:
        Successful Deploy Project:
          $ref: >-
            ./examples/analyzeconversations-authoring/SuccessfulDeployProject.json
      x-ms-long-running-operation: true
      summary: >-
        Microsoft Azure Put Authoring Analyze Conversations Projects Projectname Deployments Deploymentname
      tags:
        - Authoring
    delete:
      description: Deletes a project deployment.
      operationId: microsoftAzureConversationalanalysisauthoringDeletedeployment
      produces:
        - application/json
      parameters:
        - $ref: common.json#/parameters/ProjectNamePathParameter
        - $ref: common.json#/parameters/DeploymentNamePathParameter
        - $ref: common.json#/parameters/ApiVersionParameter
      responses:
        '202':
          description: >-
            A successful call results with an Operation-Location header used to
            check the status of the job.
          headers:
            operation-location:
              description: The location of the status API for monitoring the created job.
              type: string
        default:
          description: Error response.
          schema:
            $ref: common.json#/definitions/ErrorResponse
      x-ms-examples:
        Successful Delete Deployment:
          $ref: >-
            ./examples/analyzeconversations-authoring/SuccessfulDeleteDeployment.json
      x-ms-long-running-operation: true
      summary: >-
        Microsoft Azure Delete Authoring Analyze Conversations Projects Projectname Deployments Deploymentname
      tags:
        - Authoring
  /authoring/analyze-conversations/projects/{projectName}/deployments/{deploymentName}/:delete-from-resources:
    post:
      description: Deletes a project deployment from the specified assigned resources.
      operationId: >-
        microsoftAzureConversationalanalysisauthoringDeletedeploymentfromresources
      consumes:
        - application/json
      produces:
        - application/json
      parameters:
        - $ref: common.json#/parameters/ProjectNamePathParameter
        - $ref: common.json#/parameters/DeploymentNamePathParameter
        - in: body
          name: body
          description: The options for deleting the deployment.
          required: true
          schema:
            $ref: >-
              #/definitions/ConversationalAnalysisAuthoringDeleteDeploymentOptions
        - $ref: common.json#/parameters/ApiVersionParameter
      responses:
        '202':
          description: >-
            A successful call results with an Operation-Location header used to
            check the status of the job.
          headers:
            operation-location:
              description: The location of the status API for monitoring the created job.
              type: string
        default:
          description: Error response.
          schema:
            $ref: common.json#/definitions/ErrorResponse
      x-ms-examples:
        Successful Delete Deployment:
          $ref: >-
            ./examples/analyzeconversations-authoring/SuccessfulDeleteDeploymentFromResources.json
      x-ms-long-running-operation: true
      summary: >-
        Microsoft Azure Post Authoring Analyze Conversations Projects Projectname Deployments Deploymentname :delete From Resources
      tags:
        - Authoring
  /authoring/analyze-conversations/projects/{projectName}/deployments/{deploymentName}/delete-from-resources/jobs/{jobId}:
    get:
      description: >-
        Gets the status of an existing delete deployment from specific resources
        job.
      operationId: >-
        microsoftAzureConversationalanalysisauthoringGetdeploymentdeletefromresourcesstatus
      produces:
        - application/json
      parameters:
        - $ref: common.json#/parameters/ProjectNamePathParameter
        - $ref: common.json#/parameters/DeploymentNamePathParameter
        - $ref: '#/parameters/ConversationalAnalysisAuthoringJobIdPathParameter'
        - $ref: common.json#/parameters/ApiVersionParameter
      responses:
        '200':
          description: The deployment job result.
          schema:
            $ref: '#/definitions/ConversationalAnalysisAuthoringDeploymentJobState'
        default:
          description: Error response.
          schema:
            $ref: common.json#/definitions/ErrorResponse
      x-ms-examples:
        Successful Get Delete Deployment From Resources Status:
          $ref: >-
            ./examples/analyzeconversations-authoring/SuccessfulGetDeploymentStatus.json
      summary: >-
        Microsoft Azure Get Authoring Analyze Conversations Projects Projectname Deployments Deploymentname Delete From Resources Jobs Jobid
      tags:
        - Authoring
  /authoring/analyze-conversations/projects/{projectName}/deployments/{deploymentName}/jobs/{jobId}:
    get:
      description: Gets the status of an existing deployment job.
      operationId: microsoftAzureConversationalanalysisauthoringGetdeploymentstatus
      produces:
        - application/json
      parameters:
        - $ref: common.json#/parameters/ProjectNamePathParameter
        - $ref: common.json#/parameters/DeploymentNamePathParameter
        - $ref: '#/parameters/ConversationalAnalysisAuthoringJobIdPathParameter'
        - $ref: common.json#/parameters/ApiVersionParameter
      responses:
        '200':
          description: The deployment job result.
          schema:
            $ref: '#/definitions/ConversationalAnalysisAuthoringDeploymentJobState'
        default:
          description: Error response.
          schema:
            $ref: common.json#/definitions/ErrorResponse
      x-ms-examples:
        Successful Get Deployment Status:
          $ref: >-
            ./examples/analyzeconversations-authoring/SuccessfulGetDeploymentStatus.json
      summary: >-
        Microsoft Azure Get Authoring Analyze Conversations Projects Projectname Deployments Deploymentname Jobs Jobid
      tags:
        - Authoring
  /authoring/analyze-conversations/projects/{projectName}/deployments/swap/jobs/{jobId}:
    get:
      description: Gets the status of an existing swap deployment job.
      operationId: microsoftAzureConversationalanalysisauthoringGetswapdeploymentsstatus
      produces:
        - application/json
      parameters:
        - $ref: common.json#/parameters/ProjectNamePathParameter
        - $ref: '#/parameters/ConversationalAnalysisAuthoringJobIdPathParameter'
        - $ref: common.json#/parameters/ApiVersionParameter
      responses:
        '200':
          description: The swap deployment job result.
          schema:
            $ref: '#/definitions/ConversationalAnalysisAuthoringDeploymentJobState'
        default:
          description: Error response.
          schema:
            $ref: common.json#/definitions/ErrorResponse
      x-ms-examples:
        Successful Get Swap Deployments Status:
          $ref: >-
            ./examples/analyzeconversations-authoring/SuccessfulGetSwapDeploymentsStatus.json
      summary: >-
        Microsoft Azure Get Authoring Analyze Conversations Projects Projectname Deployments Swap Jobs Jobid
      tags:
        - Authoring
  /authoring/analyze-conversations/projects/{projectName}/export/jobs/{jobId}:
    get:
      description: >-
        Gets the status of an export job. Once job completes, returns the
        project metadata, and assets.
      operationId: microsoftAzureConversationalanalysisauthoringGetexportstatus
      produces:
        - application/json
      parameters:
        - $ref: common.json#/parameters/ProjectNamePathParameter
        - $ref: '#/parameters/ConversationalAnalysisAuthoringJobIdPathParameter'
        - $ref: common.json#/parameters/ApiVersionParameter
      responses:
        '200':
          description: The status of the long running operation.
          schema:
            $ref: '#/definitions/ConversationalAnalysisAuthoringExportProjectJobState'
        default:
          description: Error response.
          schema:
            $ref: common.json#/definitions/ErrorResponse
      x-ms-examples:
        Successful Get Export Status:
          $ref: >-
            ./examples/analyzeconversations-authoring/SuccessfulGetExportStatus.json
      summary: >-
        Microsoft Azure Get Authoring Analyze Conversations Projects Projectname Export Jobs Jobid
      tags:
        - Authoring
  /authoring/analyze-conversations/projects/{projectName}/import/jobs/{jobId}:
    get:
      description: Gets the status for an import.
      operationId: microsoftAzureConversationalanalysisauthoringGetimportstatus
      produces:
        - application/json
      parameters:
        - $ref: common.json#/parameters/ProjectNamePathParameter
        - $ref: '#/parameters/ConversationalAnalysisAuthoringJobIdPathParameter'
        - $ref: common.json#/parameters/ApiVersionParameter
      responses:
        '200':
          description: The details of the long running operation.
          schema:
            $ref: '#/definitions/ConversationalAnalysisAuthoringImportProjectJobState'
        default:
          description: Error response.
          schema:
            $ref: common.json#/definitions/ErrorResponse
      x-ms-examples:
        Successful Get Import Status:
          $ref: >-
            ./examples/analyzeconversations-authoring/SuccessfulGetImportStatus.json
      summary: >-
        Microsoft Azure Get Authoring Analyze Conversations Projects Projectname Import Jobs Jobid
      tags:
        - Authoring
  /authoring/analyze-conversations/projects/{projectName}/models:
    get:
      description: Lists the trained models belonging to a project.
      operationId: microsoftAzureConversationalanalysisauthoringListtrainedmodels
      produces:
        - application/json
      parameters:
        - $ref: common.json#/parameters/ProjectNamePathParameter
        - $ref: common.json#/parameters/TopParameter
        - $ref: common.json#/parameters/SkipParameter
        - $ref: common.json#/parameters/MaxPageSizeParameter
        - $ref: common.json#/parameters/ApiVersionParameter
      responses:
        '200':
          description: List of all trained models.
          schema:
            $ref: '#/definitions/ConversationalAnalysisAuthoringProjectTrainedModels'
        default:
          description: Error response.
          schema:
            $ref: common.json#/definitions/ErrorResponse
      x-ms-examples:
        Successful List Models:
          $ref: ./examples/analyzeconversations-authoring/SuccessfulListModels.json
      x-ms-pageable:
        nextLinkName: nextLink
        itemName: value
      summary: Microsoft Azure Get Authoring Analyze Conversations Projects Pr

# --- truncated at 32 KB (123 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/microsoft-azure/refs/heads/main/openapi/microsoft-cognitive-language-service-analyze-conversations-authoring-openapi-original.yml