Microsoft Cognitive Language Service - Question Answering Authoring (stable:2023-04-01)

2025/04/28 • 21 updated methods

QuestionAnsweringProjects_ListProjects (updated)
Description :  Gets all projects for a user.
Reference :  Link ¶

⚶ Changes

{
  "#id": "QuestionAnsweringProjects_ListProjects",
  "$parameters": [
    {
      "#name": "api-version",
      "Description": {
        "new": "The API version to use for this operation.",
        "old": "Client API version."
      }
    }
  ],
  "$responses": {
    "200": {
      "Description": {
        "new": "Paged collection of QuestionAnsweringProjectMetadata items",
        "old": "Collection of projects metadata and global settings."
      },
      "$properties": [
        {
          "#name": "value",
          "Required": {
            "new": true,
            "old": false
          },
          "$items": {
            "$properties": [
              {
                "#name": "projectName",
                "Required": {
                  "new": true,
                  "old": false
                }
              },
              {
                "#name": "language",
                "Description": {
                  "new": "Language of the text records. This is BCP-47 representation of a language. For\nexample, use \"en\" for English; \"es\" for Spanish etc. If not set, use \"en\" for\nEnglish as default.",
                  "old": "Language of the text records. This is BCP-47 representation of a language. For example, use \"en\" for English; \"es\" for Spanish etc. If not set, use \"en\" for English as default."
                }
              }
            ]
          }
        }
      ]
    },
    "default": {
      "$properties": {
        "error": [
          {
            "#name": "code",
            "Enum": {
              "new": [
                [
                  "InvalidRequest",
                  "Invalid request error"
                ],
                [
                  "InvalidArgument",
                  "Invalid argument error"
                ],
                [
                  "Unauthorized",
                  "Unauthorized access error"
                ],
                [
                  "Forbidden",
                  "Forbidden access error"
                ],
                [
                  "NotFound",
                  "Not found error"
                ],
                [
                  "ProjectNotFound",
                  "Project not found error"
                ],
                [
                  "OperationNotFound",
                  "Operation not found error"
                ],
                [
                  "AzureCognitiveSearchNotFound",
                  "Azure Cognitive Search not found error"
                ],
                [
                  "AzureCognitiveSearchIndexNotFound",
                  "Azure Cognitive Search index not found error"
                ],
                [
                  "TooManyRequests",
                  "Too many requests error"
                ],
                [
                  "AzureCognitiveSearchThrottling",
                  "Azure Cognitive Search throttling error"
                ],
                [
                  "AzureCognitiveSearchIndexLimitReached",
                  "Azure Cognitive Search index limit reached error"
                ],
                [
                  "InternalServerError",
                  "Internal server error"
                ],
                [
                  "ServiceUnavailable",
                  "Service unavailable error"
                ],
                [
                  "Timeout",
                  "Timeout error"
                ],
                [
                  "QuotaExceeded",
                  "Quota exceeded error"
                ],
                [
                  "Conflict",
                  "Conflict error"
                ],
                [
                  "Warning",
                  "Warning error"
                ]
              ],
              "old": [
                [
                  "InvalidRequest",
                  ""
                ],
                [
                  "InvalidArgument",
                  ""
                ],
                [
                  "Unauthorized",
                  ""
                ],
                [
                  "Forbidden",
                  ""
                ],
                [
                  "NotFound",
                  ""
                ],
                [
                  "ProjectNotFound",
                  ""
                ],
                [
                  "OperationNotFound",
                  ""
                ],
                [
                  "AzureCognitiveSearchNotFound",
                  ""
                ],
                [
                  "AzureCognitiveSearchIndexNotFound",
                  ""
                ],
                [
                  "TooManyRequests",
                  ""
                ],
                [
                  "AzureCognitiveSearchThrottling",
                  ""
                ],
                [
                  "AzureCognitiveSearchIndexLimitReached",
                  ""
                ],
                [
                  "InternalServerError",
                  ""
                ],
                [
                  "ServiceUnavailable",
                  ""
                ],
                [
                  "Timeout",
                  ""
                ],
                [
                  "QuotaExceeded",
                  ""
                ],
                [
                  "Conflict",
                  ""
                ],
                [
                  "Warning",
                  ""
                ]
              ]
            }
          },
          {
            "#name": "innererror",
            "Description": {
              "new": "An object containing more specific information than the current object about\nthe error.",
              "old": "An object containing more specific information than the current object about the error."
            },
            "$properties": [
              {
                "#name": "code",
                "Enum": {
                  "new": [
                    [
                      "InvalidRequest",
                      "Invalid request error"
                    ],
                    [
                      "InvalidParameterValue",
                      "Invalid parameter value error"
                    ],
                    [
                      "KnowledgeBaseNotFound",
                      "Knowledge base not found error"
                    ],
                    [
                      "AzureCognitiveSearchNotFound",
                      "Azure Cognitive Search not found error"
                    ],
                    [
                      "AzureCognitiveSearchThrottling",
                      "Azure Cognitive Search throttling error"
                    ],
                    [
                      "ExtractionFailure",
                      "Extraction failure error"
                    ],
                    [
                      "InvalidRequestBodyFormat",
                      "Invalid request body format error"
                    ],
                    [
                      "EmptyRequest",
                      "Empty request error"
                    ],
                    [
                      "MissingInputDocuments",
                      "Missing input documents error"
                    ],
                    [
                      "InvalidDocument",
                      "Invalid document error"
                    ],
                    [
                      "ModelVersionIncorrect",
                      "Model version incorrect error"
                    ],
                    [
                      "InvalidDocumentBatch",
                      "Invalid document batch error"
                    ],
                    [
                      "UnsupportedLanguageCode",
                      "Unsupported language code error"
                    ],
                    [
                      "InvalidCountryHint",
                      "Invalid country hint error"
                    ]
                  ],
                  "old": [
                    [
                      "InvalidRequest",
                      ""
                    ],
                    [
                      "InvalidParameterValue",
                      ""
                    ],
                    [
                      "KnowledgeBaseNotFound",
                      ""
                    ],
                    [
                      "AzureCognitiveSearchNotFound",
                      ""
                    ],
                    [
                      "AzureCognitiveSearchThrottling",
                      ""
                    ],
                    [
                      "ExtractionFailure",
                      ""
                    ],
                    [
                      "InvalidRequestBodyFormat",
                      ""
                    ],
                    [
                      "EmptyRequest",
                      ""
                    ],
                    [
                      "MissingInputDocuments",
                      ""
                    ],
                    [
                      "InvalidDocument",
                      ""
                    ],
                    [
                      "ModelVersionIncorrect",
                      ""
                    ],
                    [
                      "InvalidDocumentBatch",
                      ""
                    ],
                    [
                      "UnsupportedLanguageCode",
                      ""
                    ],
                    [
                      "InvalidCountryHint",
                      ""
                    ]
                  ]
                }
              }
            ]
          }
        ]
      }
    }
  }
}

⚼ Request

GET:  /authoring/query-knowledgebases/projects
{
api-version:
{
Description: The API version to use for this operation. ,
Required: True ,
}
string ,
top:
{
Description: The maximum number of resources to return from the collection. ,
Format: int32 ,
Required: False ,
}
integer ,
skip:
{
Description: An offset into the collection of the first resource to be returned. ,
Format: int32 ,
Required: False ,
}
integer ,
maxpagesize:
{
Description: The maximum number of resources to include in a single response. ,
Format: int32 ,
Required: False ,
}
integer ,
}

⚐ Response (200)

{
value:
{
Description: The QuestionAnsweringProjectMetadata items on this page ,
Required: True ,
}
[
{
projectName:
{
Description: Name of the project. ,
Required: True ,
}
string ,
description:
{
Description: Description of the project. ,
Required: False ,
}
string ,
language:
{
Description: Language of the text records. This is BCP-47 representation of a language. For example, use "en" for English; "es" for Spanish etc. If not set, use "en" for English as default. ,
Required: False ,
}
string ,
multilingualResource:
{
Description: Resource enabled for multiple languages across projects or not. ,
Required: False ,
}
boolean ,
settings:
{
Description: Configurable settings of the Project. ,
Required: False ,
}
{
defaultAnswer:
{
Description: Default Answer response when no good match is found in the knowledge base. ,
Required: False ,
}
string ,
}
,
createdDateTime:
{
Description: Project creation date-time. ,
Format: date-time ,
Required: False ,
}
string ,
lastModifiedDateTime:
{
Description: Represents the project last modified date-time. ,
Format: date-time ,
Required: False ,
}
string ,
lastDeployedDateTime:
{
Description: Represents the project last deployment date-time. ,
Format: date-time ,
Required: False ,
}
string ,
}
,
]
,
nextLink:
{
Description: The link to the next page of items ,
Format: uri ,
Required: False ,
}
string ,
}

⚐ Response (default)

{
$headers:
{
x-ms-error-code:
{
Description: String error code indicating what went wrong. ,
}
string ,
}
,
$schema:
{
Description: Error response. ,
}
{
error:
{
Description: The error object. ,
Required: True ,
}
{
code:
{
Description: One of a server-defined set of error codes. ,
Enum:
{
InvalidRequest: Invalid request error ,
InvalidArgument: Invalid argument error ,
Unauthorized: Unauthorized access error ,
Forbidden: Forbidden access error ,
NotFound: Not found error ,
ProjectNotFound: Project not found error ,
OperationNotFound: Operation not found error ,
AzureCognitiveSearchNotFound: Azure Cognitive Search not found error ,
AzureCognitiveSearchIndexNotFound: Azure Cognitive Search index not found error ,
TooManyRequests: Too many requests error ,
AzureCognitiveSearchThrottling: Azure Cognitive Search throttling error ,
AzureCognitiveSearchIndexLimitReached: Azure Cognitive Search index limit reached error ,
InternalServerError: Internal server error ,
ServiceUnavailable: Service unavailable error ,
Timeout: Timeout error ,
QuotaExceeded: Quota exceeded error ,
Conflict: Conflict error ,
Warning: Warning error ,
}
,
Required: True ,
}
enum ,
message:
{
Description: A human-readable representation of the error. ,
Required: True ,
}
string ,
target:
{
Description: The target of the error. ,
Required: False ,
}
string ,
details:
{
Description: An array of details about specific errors that led to this reported error. ,
Required: False ,
}
[
string ,
]
,
innererror:
{
Description: An object containing more specific information than the current object about the error. ,
Required: False ,
}
{
code:
{
Description: One of a server-defined set of error codes. ,
Enum:
{
InvalidRequest: Invalid request error ,
InvalidParameterValue: Invalid parameter value error ,
KnowledgeBaseNotFound: Knowledge base not found error ,
AzureCognitiveSearchNotFound: Azure Cognitive Search not found error ,
AzureCognitiveSearchThrottling: Azure Cognitive Search throttling error ,
ExtractionFailure: Extraction failure error ,
InvalidRequestBodyFormat: Invalid request body format error ,
EmptyRequest: Empty request error ,
MissingInputDocuments: Missing input documents error ,
InvalidDocument: Invalid document error ,
ModelVersionIncorrect: Model version incorrect error ,
InvalidDocumentBatch: Invalid document batch error ,
UnsupportedLanguageCode: Unsupported language code error ,
InvalidCountryHint: Invalid country hint error ,
}
,
Required: True ,
}
enum ,
message:
{
Description: Error message. ,
Required: True ,
}
string ,
details:
{
Description: Error details. ,
Required: False ,
}
object ,
target:
{
Description: Error target. ,
Required: False ,
}
string ,
innererror:
{
Required: False ,
}
string ,
}
,
}
,
}
,
}
QuestionAnsweringProjects_GetProjectDetails (updated)
Description :  Get the requested project metadata.
Reference :  Link ¶

⚶ Changes

{
  "#id": "QuestionAnsweringProjects_GetProjectDetails",
  "$parameters": [
    {
      "#name": "api-version",
      "Description": {
        "new": "The API version to use for this operation.",
        "old": "Client API version."
      }
    },
    {
      "#name": "projectName",
      "Description": {
        "new": "Name of the project.",
        "old": "The name of the project to use."
      }
    }
  ],
  "$responses": {
    "200": {
      "$properties": [
        {
          "#name": "projectName",
          "Required": {
            "new": true,
            "old": false
          }
        },
        {
          "#name": "language",
          "Description": {
            "new": "Language of the text records. This is BCP-47 representation of a language. For\nexample, use \"en\" for English; \"es\" for Spanish etc. If not set, use \"en\" for\nEnglish as default.",
            "old": "Language of the text records. This is BCP-47 representation of a language. For example, use \"en\" for English; \"es\" for Spanish etc. If not set, use \"en\" for English as default."
          }
        }
      ]
    },
    "default": {
      "$properties": {
        "error": [
          {
            "#name": "code",
            "Enum": {
              "new": [
                [
                  "InvalidRequest",
                  "Invalid request error"
                ],
                [
                  "InvalidArgument",
                  "Invalid argument error"
                ],
                [
                  "Unauthorized",
                  "Unauthorized access error"
                ],
                [
                  "Forbidden",
                  "Forbidden access error"
                ],
                [
                  "NotFound",
                  "Not found error"
                ],
                [
                  "ProjectNotFound",
                  "Project not found error"
                ],
                [
                  "OperationNotFound",
                  "Operation not found error"
                ],
                [
                  "AzureCognitiveSearchNotFound",
                  "Azure Cognitive Search not found error"
                ],
                [
                  "AzureCognitiveSearchIndexNotFound",
                  "Azure Cognitive Search index not found error"
                ],
                [
                  "TooManyRequests",
                  "Too many requests error"
                ],
                [
                  "AzureCognitiveSearchThrottling",
                  "Azure Cognitive Search throttling error"
                ],
                [
                  "AzureCognitiveSearchIndexLimitReached",
                  "Azure Cognitive Search index limit reached error"
                ],
                [
                  "InternalServerError",
                  "Internal server error"
                ],
                [
                  "ServiceUnavailable",
                  "Service unavailable error"
                ],
                [
                  "Timeout",
                  "Timeout error"
                ],
                [
                  "QuotaExceeded",
                  "Quota exceeded error"
                ],
                [
                  "Conflict",
                  "Conflict error"
                ],
                [
                  "Warning",
                  "Warning error"
                ]
              ],
              "old": [
                [
                  "InvalidRequest",
                  ""
                ],
                [
                  "InvalidArgument",
                  ""
                ],
                [
                  "Unauthorized",
                  ""
                ],
                [
                  "Forbidden",
                  ""
                ],
                [
                  "NotFound",
                  ""
                ],
                [
                  "ProjectNotFound",
                  ""
                ],
                [
                  "OperationNotFound",
                  ""
                ],
                [
                  "AzureCognitiveSearchNotFound",
                  ""
                ],
                [
                  "AzureCognitiveSearchIndexNotFound",
                  ""
                ],
                [
                  "TooManyRequests",
                  ""
                ],
                [
                  "AzureCognitiveSearchThrottling",
                  ""
                ],
                [
                  "AzureCognitiveSearchIndexLimitReached",
                  ""
                ],
                [
                  "InternalServerError",
                  ""
                ],
                [
                  "ServiceUnavailable",
                  ""
                ],
                [
                  "Timeout",
                  ""
                ],
                [
                  "QuotaExceeded",
                  ""
                ],
                [
                  "Conflict",
                  ""
                ],
                [
                  "Warning",
                  ""
                ]
              ]
            }
          },
          {
            "#name": "innererror",
            "Description": {
              "new": "An object containing more specific information than the current object about\nthe error.",
              "old": "An object containing more specific information than the current object about the error."
            },
            "$properties": [
              {
                "#name": "code",
                "Enum": {
                  "new": [
                    [
                      "InvalidRequest",
                      "Invalid request error"
                    ],
                    [
                      "InvalidParameterValue",
                      "Invalid parameter value error"
                    ],
                    [
                      "KnowledgeBaseNotFound",
                      "Knowledge base not found error"
                    ],
                    [
                      "AzureCognitiveSearchNotFound",
                      "Azure Cognitive Search not found error"
                    ],
                    [
                      "AzureCognitiveSearchThrottling",
                      "Azure Cognitive Search throttling error"
                    ],
                    [
                      "ExtractionFailure",
                      "Extraction failure error"
                    ],
                    [
                      "InvalidRequestBodyFormat",
                      "Invalid request body format error"
                    ],
                    [
                      "EmptyRequest",
                      "Empty request error"
                    ],
                    [
                      "MissingInputDocuments",
                      "Missing input documents error"
                    ],
                    [
                      "InvalidDocument",
                      "Invalid document error"
                    ],
                    [
                      "ModelVersionIncorrect",
                      "Model version incorrect error"
                    ],
                    [
                      "InvalidDocumentBatch",
                      "Invalid document batch error"
                    ],
                    [
                      "UnsupportedLanguageCode",
                      "Unsupported language code error"
                    ],
                    [
                      "InvalidCountryHint",
                      "Invalid country hint error"
                    ]
                  ],
                  "old": [
                    [
                      "InvalidRequest",
                      ""
                    ],
                    [
                      "InvalidParameterValue",
                      ""
                    ],
                    [
                      "KnowledgeBaseNotFound",
                      ""
                    ],
                    [
                      "AzureCognitiveSearchNotFound",
                      ""
                    ],
                    [
                      "AzureCognitiveSearchThrottling",
                      ""
                    ],
                    [
                      "ExtractionFailure",
                      ""
                    ],
                    [
                      "InvalidRequestBodyFormat",
                      ""
                    ],
                    [
                      "EmptyRequest",
                      ""
                    ],
                    [
                      "MissingInputDocuments",
                      ""
                    ],
                    [
                      "InvalidDocument",
                      ""
                    ],
                    [
                      "ModelVersionIncorrect",
                      ""
                    ],
                    [
                      "InvalidDocumentBatch",
                      ""
                    ],
                    [
                      "UnsupportedLanguageCode",
                      ""
                    ],
                    [
                      "InvalidCountryHint",
                      ""
                    ]
                  ]
                }
              }
            ]
          }
        ]
      }
    }
  }
}

⚼ Request

GET:  /authoring/query-knowledgebases/projects/{projectName}
{
api-version:
{
Description: The API version to use for this operation. ,
Required: True ,
}
string ,
projectName:
{
Description: Name of the project. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
projectName:
{
Description: Name of the project. ,
Required: True ,
}
string ,
description:
{
Description: Description of the project. ,
Required: False ,
}
string ,
language:
{
Description: Language of the text records. This is BCP-47 representation of a language. For example, use "en" for English; "es" for Spanish etc. If not set, use "en" for English as default. ,
Required: False ,
}
string ,
multilingualResource:
{
Description: Resource enabled for multiple languages across projects or not. ,
Required: False ,
}
boolean ,
settings:
{
Description: Configurable settings of the Project. ,
Required: False ,
}
{
defaultAnswer:
{
Description: Default Answer response when no good match is found in the knowledge base. ,
Required: False ,
}
string ,
}
,
createdDateTime:
{
Description: Project creation date-time. ,
Format: date-time ,
Required: False ,
}
string ,
lastModifiedDateTime:
{
Description: Represents the project last modified date-time. ,
Format: date-time ,
Required: False ,
}
string ,
lastDeployedDateTime:
{
Description: Represents the project last deployment date-time. ,
Format: date-time ,
Required: False ,
}
string ,
}

⚐ Response (default)

{
$headers:
{
x-ms-error-code:
{
Description: String error code indicating what went wrong. ,
}
string ,
}
,
$schema:
{
Description: Error response. ,
}
{
error:
{
Description: The error object. ,
Required: True ,
}
{
code:
{
Description: One of a server-defined set of error codes. ,
Enum:
{
InvalidRequest: Invalid request error ,
InvalidArgument: Invalid argument error ,
Unauthorized: Unauthorized access error ,
Forbidden: Forbidden access error ,
NotFound: Not found error ,
ProjectNotFound: Project not found error ,
OperationNotFound: Operation not found error ,
AzureCognitiveSearchNotFound: Azure Cognitive Search not found error ,
AzureCognitiveSearchIndexNotFound: Azure Cognitive Search index not found error ,
TooManyRequests: Too many requests error ,
AzureCognitiveSearchThrottling: Azure Cognitive Search throttling error ,
AzureCognitiveSearchIndexLimitReached: Azure Cognitive Search index limit reached error ,
InternalServerError: Internal server error ,
ServiceUnavailable: Service unavailable error ,
Timeout: Timeout error ,
QuotaExceeded: Quota exceeded error ,
Conflict: Conflict error ,
Warning: Warning error ,
}
,
Required: True ,
}
enum ,
message:
{
Description: A human-readable representation of the error. ,
Required: True ,
}
string ,
target:
{
Description: The target of the error. ,
Required: False ,
}
string ,
details:
{
Description: An array of details about specific errors that led to this reported error. ,
Required: False ,
}
[
string ,
]
,
innererror:
{
Description: An object containing more specific information than the current object about the error. ,
Required: False ,
}
{
code:
{
Description: One of a server-defined set of error codes. ,
Enum:
{
InvalidRequest: Invalid request error ,
InvalidParameterValue: Invalid parameter value error ,
KnowledgeBaseNotFound: Knowledge base not found error ,
AzureCognitiveSearchNotFound: Azure Cognitive Search not found error ,
AzureCognitiveSearchThrottling: Azure Cognitive Search throttling error ,
ExtractionFailure: Extraction failure error ,
InvalidRequestBodyFormat: Invalid request body format error ,
EmptyRequest: Empty request error ,
MissingInputDocuments: Missing input documents error ,
InvalidDocument: Invalid document error ,
ModelVersionIncorrect: Model version incorrect error ,
InvalidDocumentBatch: Invalid document batch error ,
UnsupportedLanguageCode: Unsupported language code error ,
InvalidCountryHint: Invalid country hint error ,
}
,
Required: True ,
}
enum ,
message:
{
Description: Error message. ,
Required: True ,
}
string ,
details:
{
Description: Error details. ,
Required: False ,
}
object ,
target:
{
Description: Error target. ,
Required: False ,
}
string ,
innererror:
{
Required: False ,
}
string ,
}
,
}
,
}
,
}
QuestionAnsweringProjects_CreateProject (updated)
Description :  Create or update a project.
Reference :  Link ¶

⚶ Changes

{
  "#id": "QuestionAnsweringProjects_CreateProject",
  "$parameters": [
    {
      "#name": "api-version",
      "Description": {
        "new": "The API version to use for this operation.",
        "old": "Client API version."
      }
    },
    {
      "#name": "projectName",
      "Description": {
        "new": "Name of the project.",
        "old": "The name of the project to use."
      }
    },
    {
      "#name": "body",
      "Description": {
        "new": "The resource instance.",
        "old": "Parameters needed to create the project."
      },
      "$schema": {
        "Description": {
          "new": "Represents the project.",
          "old": "Parameters needed to create the project."
        },
        "$properties": [
          {
            "#name": "language",
            "Description": {
              "new": "Language of the text records. This is BCP-47 representation of a language. For\nexample, use \"en\" for English; \"es\" for Spanish etc. If not set, use \"en\" for\nEnglish as default.",
              "old": "Language of the text records. This is BCP-47 representation of a language. For example, use \"en\" for English; \"es\" for Spanish etc. If not set, use \"en\" for English as default."
            },
            "Required": {
              "new": false,
              "old": true
            }
          },
          {
            "#name": "multilingualResource",
            "Description": {
              "new": "Resource enabled for multiple languages across projects or not.",
              "old": "Set to true to enable creating knowledgebases in different languages for the same resource."
            }
          }
        ]
      }
    }
  ],
  "$responses": {
    "200": {
      "$properties": [
        {
          "#name": "projectName",
          "Required": {
            "new": true,
            "old": false
          }
        },
        {
          "#name": "language",
          "Description": {
            "new": "Language of the text records. This is BCP-47 representation of a language. For\nexample, use \"en\" for English; \"es\" for Spanish etc. If not set, use \"en\" for\nEnglish as default.",
            "old": "Language of the text records. This is BCP-47 representation of a language. For example, use \"en\" for English; \"es\" for Spanish etc. If not set, use \"en\" for English as default."
          }
        }
      ]
    },
    "201": {
      "$properties": [
        {
          "#name": "projectName",
          "Required": {
            "new": true,
            "old": false
          }
        },
        {
          "#name": "language",
          "Description": {
            "new": "Language of the text records. This is BCP-47 representation of a language. For\nexample, use \"en\" for English; \"es\" for Spanish etc. If not set, use \"en\" for\nEnglish as default.",
            "old": "Language of the text records. This is BCP-47 representation of a language. For example, use \"en\" for English; \"es\" for Spanish etc. If not set, use \"en\" for English as default."
          }
        }
      ]
    },
    "default": {
      "$properties": {
        "error": [
          {
            "#name": "code",
            "Enum": {
              "new": [
                [
                  "InvalidRequest",
                  "Invalid request error"
                ],
                [
                  "InvalidArgument",
                  "Invalid argument error"
                ],
                [
                  "Unauthorized",
                  "Unauthorized access error"
                ],
                [
                  "Forbidden",
                  "Forbidden access error"
                ],
                [
                  "NotFound",
                  "Not found error"
                ],
                [
                  "ProjectNotFound",
                  "Project not found error"
                ],
                [
                  "OperationNotFound",
                  "Operation not found error"
                ],
                [
                  "AzureCognitiveSearchNotFound",
                  "Azure Cognitive Search not found error"
                ],
                [
                  "AzureCognitiveSearchIndexNotFound",
                  "Azure Cognitive Search index not found error"
                ],
                [
                  "TooManyRequests",
                  "Too many requests error"
                ],
                [
                  "AzureCognitiveSearchThrottling",
                  "Azure Cognitive Search throttling error"
                ],
                [
                  "AzureCognitiveSearchIndexLimitReached",
                  "Azure Cognitive Search index limit reached error"
                ],
                [
                  "InternalServerError",
                  "Internal server error"
                ],
                [
                  "ServiceUnavailable",
                  "Service unavailable error"
                ],
                [
                  "Timeout",
                  "Timeout error"
                ],
                [
                  "QuotaExceeded",
                  "Quota exceeded error"
                ],
                [
                  "Conflict",
                  "Conflict error"
                ],
                [
                  "Warning",
                  "Warning error"
                ]
              ],
              "old": [
                [
                  "InvalidRequest",
                  ""
                ],
                [
                  "InvalidArgument",
                  ""
                ],
                [
                  "Unauthorized",
                  ""
                ],
                [
                  "Forbidden",
                  ""
                ],
                [
                  "NotFound",
                  ""
                ],
                [
                  "ProjectNotFound",
                  ""
                ],
                [
                  "OperationNotFound",
                  ""
                ],
                [
                  "AzureCognitiveSearchNotFound",
                  ""
                ],
                [
                  "AzureCognitiveSearchIndexNotFound",
                  ""
                ],
                [
                  "TooManyRequests",
                  ""
                ],
                [
                  "AzureCognitiveSearchThrottling",
                  ""
                ],
                [
                  "AzureCognitiveSearchIndexLimitReached",
                  ""
                ],
                [
                  "InternalServerError",
                  ""
                ],
                [
                  "ServiceUnavailable",
                  ""
                ],
                [
                  "Timeout",
                  ""
                ],
                [
                  "QuotaExceeded",
                  ""
                ],
                [
                  "Conflict",
                  ""
                ],
                [
                  "Warning",
                  ""
                ]
              ]
            }
          },
          {
            "#name": "innererror",
            "Description": {
              "new": "An object containing more specific information than the current object about\nthe error.",
              "old": "An object containing more specific information than the current object about the error."
            },
            "$properties": [
              {
                "#name": "code",
                "Enum": {
                  "new": [
                    [
                      "InvalidRequest",
                      "Invalid request error"
                    ],
                    [
                      "InvalidParameterValue",
                      "Invalid parameter value error"
                    ],
                    [
                      "KnowledgeBaseNotFound",
                      "Knowledge base not found error"
                    ],
                    [
                      "AzureCognitiveSearchNotFound",
                      "Azure Cognitive Search not found error"
                    ],
                    [
                      "AzureCognitiveSearchThrottling",
                      "Azure Cognitive Search throttling error"
                    ],
                    [
                      "ExtractionFailure",
                      "Extraction failure error"
                    ],
                    [
                      "InvalidRequestBodyFormat",
                      "Invalid request body format error"
                    ],
                    [
                      "EmptyRequest",
                      "Empty request error"
                    ],
                    [
                      "MissingInputDocuments",
                      "Missing input documents error"
                    ],
                    [
                      "InvalidDocument",
                      "Invalid document error"
                    ],
                    [
                      "ModelVersionIncorrect",
                      "Model version incorrect error"
                    ],
                    [
                      "InvalidDocumentBatch",
                      "Invalid document batch error"
                    ],
                    [
                      "UnsupportedLanguageCode",
                      "Unsupported language code error"
                    ],
                    [
                      "InvalidCountryHint",
                      "Invalid country hint error"
                    ]
                  ],
                  "old": [
                    [
                      "InvalidRequest",
                      ""
                    ],
                    [
                      "InvalidParameterValue",
                      ""
                    ],
                    [
                      "KnowledgeBaseNotFound",
                      ""
                    ],
                    [
                      "AzureCognitiveSearchNotFound",
                      ""
                    ],
                    [
                      "AzureCognitiveSearchThrottling",
                      ""
                    ],
                    [
                      "ExtractionFailure",
                      ""
                    ],
                    [
                      "InvalidRequestBodyFormat",
                      ""
                    ],
                    [
                      "EmptyRequest",
                      ""
                    ],
                    [
                      "MissingInputDocuments",
                      ""
                    ],
                    [
                      "InvalidDocument",
                      ""
                    ],
                    [
                      "ModelVersionIncorrect",
                      ""
                    ],
                    [
                      "InvalidDocumentBatch",
                      ""
                    ],
                    [
                      "UnsupportedLanguageCode",
                      ""
                    ],
                    [
                      "InvalidCountryHint",
                      ""
                    ]
                  ]
                }
              }
            ]
          }
        ]
      }
    }
  }
}

⚼ Request

PATCH:  /authoring/query-knowledgebases/projects/{projectName}
{
api-version:
{
Description: The API version to use for this operation. ,
Required: True ,
}
string ,
projectName:
{
Description: Name of the project. ,
Required: True ,
}
string ,
body:
{
Description: The resource instance. ,
Required: True ,
}
{
description:
{
Description: Description of the project. ,
Required: False ,
}
string ,
language:
{
Description: Language of the text records. This is BCP-47 representation of a language. For example, use "en" for English; "es" for Spanish etc. If not set, use "en" for English as default. ,
Required: False ,
}
string ,
multilingualResource:
{
Description: Resource enabled for multiple languages across projects or not. ,
Required: False ,
}
boolean ,
settings:
{
Description: Configurable settings of the Project. ,
Required: False ,
}
{
defaultAnswer:
{
Description: Default Answer response when no good match is found in the knowledge base. ,
Required: False ,
}
string ,
}
,
}
,
}

⚐ Response (200)

{
projectName:
{
Description: Name of the project. ,
Required: True ,
}
string ,
description:
{
Description: Description of the project. ,
Required: False ,
}
string ,
language:
{
Description: Language of the text records. This is BCP-47 representation of a language. For example, use "en" for English; "es" for Spanish etc. If not set, use "en" for English as default. ,
Required: False ,
}
string ,
multilingualResource:
{
Description: Resource enabled for multiple languages across projects or not. ,
Required: False ,
}
boolean ,
settings:
{
Description: Configurable settings of the Project. ,
Required: False ,
}
{
defaultAnswer:
{
Description: Default Answer response when no good match is found in the knowledge base. ,
Required: False ,
}
string ,
}
,
createdDateTime:
{
Description: Project creation date-time. ,
Format: date-time ,
Required: False ,
}
string ,
lastModifiedDateTime:
{
Description: Represents the project last modified date-time. ,
Format: date-time ,
Required: False ,
}
string ,
lastDeployedDateTime:
{
Description: Represents the project last deployment date-time. ,
Format: date-time ,
Required: False ,
}
string ,
}

⚐ Response (201)

{
projectName:
{
Description: Name of the project. ,
Required: True ,
}
string ,
description:
{
Description: Description of the project. ,
Required: False ,
}
string ,
language:
{
Description: Language of the text records. This is BCP-47 representation of a language. For example, use "en" for English; "es" for Spanish etc. If not set, use "en" for English as default. ,
Required: False ,
}
string ,
multilingualResource:
{
Description: Resource enabled for multiple languages across projects or not. ,
Required: False ,
}
boolean ,
settings:
{
Description: Configurable settings of the Project. ,
Required: False ,
}
{
defaultAnswer:
{
Description: Default Answer response when no good match is found in the knowledge base. ,
Required: False ,
}
string ,
}
,
createdDateTime:
{
Description: Project creation date-time. ,
Format: date-time ,
Required: False ,
}
string ,
lastModifiedDateTime:
{
Description: Represents the project last modified date-time. ,
Format: date-time ,
Required: False ,
}
string ,
lastDeployedDateTime:
{
Description: Represents the project last deployment date-time. ,
Format: date-time ,
Required: False ,
}
string ,
}

⚐ Response (default)

{
$headers:
{
x-ms-error-code:
{
Description: String error code indicating what went wrong. ,
}
string ,
}
,
$schema:
{
Description: Error response. ,
}
{
error:
{
Description: The error object. ,
Required: True ,
}
{
code:
{
Description: One of a server-defined set of error codes. ,
Enum:
{
InvalidRequest: Invalid request error ,
InvalidArgument: Invalid argument error ,
Unauthorized: Unauthorized access error ,
Forbidden: Forbidden access error ,
NotFound: Not found error ,
ProjectNotFound: Project not found error ,
OperationNotFound: Operation not found error ,
AzureCognitiveSearchNotFound: Azure Cognitive Search not found error ,
AzureCognitiveSearchIndexNotFound: Azure Cognitive Search index not found error ,
TooManyRequests: Too many requests error ,
AzureCognitiveSearchThrottling: Azure Cognitive Search throttling error ,
AzureCognitiveSearchIndexLimitReached: Azure Cognitive Search index limit reached error ,
InternalServerError: Internal server error ,
ServiceUnavailable: Service unavailable error ,
Timeout: Timeout error ,
QuotaExceeded: Quota exceeded error ,
Conflict: Conflict error ,
Warning: Warning error ,
}
,
Required: True ,
}
enum ,
message:
{
Description: A human-readable representation of the error. ,
Required: True ,
}
string ,
target:
{
Description: The target of the error. ,
Required: False ,
}
string ,
details:
{
Description: An array of details about specific errors that led to this reported error. ,
Required: False ,
}
[
string ,
]
,
innererror:
{
Description: An object containing more specific information than the current object about the error. ,
Required: False ,
}
{
code:
{
Description: One of a server-defined set of error codes. ,
Enum:
{
InvalidRequest: Invalid request error ,
InvalidParameterValue: Invalid parameter value error ,
KnowledgeBaseNotFound: Knowledge base not found error ,
AzureCognitiveSearchNotFound: Azure Cognitive Search not found error ,
AzureCognitiveSearchThrottling: Azure Cognitive Search throttling error ,
ExtractionFailure: Extraction failure error ,
InvalidRequestBodyFormat: Invalid request body format error ,
EmptyRequest: Empty request error ,
MissingInputDocuments: Missing input documents error ,
InvalidDocument: Invalid document error ,
ModelVersionIncorrect: Model version incorrect error ,
InvalidDocumentBatch: Invalid document batch error ,
UnsupportedLanguageCode: Unsupported language code error ,
InvalidCountryHint: Invalid country hint error ,
}
,
Required: True ,
}
enum ,
message:
{
Description: Error message. ,
Required: True ,
}
string ,
details:
{
Description: Error details. ,
Required: False ,
}
object ,
target:
{
Description: Error target. ,
Required: False ,
}
string ,
innererror:
{
Required: False ,
}
string ,
}
,
}
,
}
,
}
QuestionAnsweringProjects_DeleteProject (updated)
Description :  Delete the project.
Reference :  Link ¶

⚶ Changes

{
  "#id": "QuestionAnsweringProjects_DeleteProject",
  "$parameters": [
    {
      "#name": "api-version",
      "Description": {
        "new": "The API version to use for this operation.",
        "old": "Client API version."
      }
    }
  ],
  "$responses": {
    "default": {
      "$properties": {
        "error": [
          {
            "#name": "code",
            "Enum": {
              "new": [
                [
                  "InvalidRequest",
                  "Invalid request error"
                ],
                [
                  "InvalidArgument",
                  "Invalid argument error"
                ],
                [
                  "Unauthorized",
                  "Unauthorized access error"
                ],
                [
                  "Forbidden",
                  "Forbidden access error"
                ],
                [
                  "NotFound",
                  "Not found error"
                ],
                [
                  "ProjectNotFound",
                  "Project not found error"
                ],
                [
                  "OperationNotFound",
                  "Operation not found error"
                ],
                [
                  "AzureCognitiveSearchNotFound",
                  "Azure Cognitive Search not found error"
                ],
                [
                  "AzureCognitiveSearchIndexNotFound",
                  "Azure Cognitive Search index not found error"
                ],
                [
                  "TooManyRequests",
                  "Too many requests error"
                ],
                [
                  "AzureCognitiveSearchThrottling",
                  "Azure Cognitive Search throttling error"
                ],
                [
                  "AzureCognitiveSearchIndexLimitReached",
                  "Azure Cognitive Search index limit reached error"
                ],
                [
                  "InternalServerError",
                  "Internal server error"
                ],
                [
                  "ServiceUnavailable",
                  "Service unavailable error"
                ],
                [
                  "Timeout",
                  "Timeout error"
                ],
                [
                  "QuotaExceeded",
                  "Quota exceeded error"
                ],
                [
                  "Conflict",
                  "Conflict error"
                ],
                [
                  "Warning",
                  "Warning error"
                ]
              ],
              "old": [
                [
                  "InvalidRequest",
                  ""
                ],
                [
                  "InvalidArgument",
                  ""
                ],
                [
                  "Unauthorized",
                  ""
                ],
                [
                  "Forbidden",
                  ""
                ],
                [
                  "NotFound",
                  ""
                ],
                [
                  "ProjectNotFound",
                  ""
                ],
                [
                  "OperationNotFound",
                  ""
                ],
                [
                  "AzureCognitiveSearchNotFound",
                  ""
                ],
                [
                  "AzureCognitiveSearchIndexNotFound",
                  ""
                ],
                [
                  "TooManyRequests",
                  ""
                ],
                [
                  "AzureCognitiveSearchThrottling",
                  ""
                ],
                [
                  "AzureCognitiveSearchIndexLimitReached",
                  ""
                ],
                [
                  "InternalServerError",
                  ""
                ],
                [
                  "ServiceUnavailable",
                  ""
                ],
                [
                  "Timeout",
                  ""
                ],
                [
                  "QuotaExceeded",
                  ""
                ],
                [
                  "Conflict",
                  ""
                ],
                [
                  "Warning",
                  ""
                ]
              ]
            }
          },
          {
            "#name": "innererror",
            "Description": {
              "new": "An object containing more specific information than the current object about\nthe error.",
              "old": "An object containing more specific information than the current object about the error."
            },
            "$properties": [
              {
                "#name": "code",
                "Enum": {
                  "new": [
                    [
                      "InvalidRequest",
                      "Invalid request error"
                    ],
                    [
                      "InvalidParameterValue",
                      "Invalid parameter value error"
                    ],
                    [
                      "KnowledgeBaseNotFound",
                      "Knowledge base not found error"
                    ],
                    [
                      "AzureCognitiveSearchNotFound",
                      "Azure Cognitive Search not found error"
                    ],
                    [
                      "AzureCognitiveSearchThrottling",
                      "Azure Cognitive Search throttling error"
                    ],
                    [
                      "ExtractionFailure",
                      "Extraction failure error"
                    ],
                    [
                      "InvalidRequestBodyFormat",
                      "Invalid request body format error"
                    ],
                    [
                      "EmptyRequest",
                      "Empty request error"
                    ],
                    [
                      "MissingInputDocuments",
                      "Missing input documents error"
                    ],
                    [
                      "InvalidDocument",
                      "Invalid document error"
                    ],
                    [
                      "ModelVersionIncorrect",
                      "Model version incorrect error"
                    ],
                    [
                      "InvalidDocumentBatch",
                      "Invalid document batch error"
                    ],
                    [
                      "UnsupportedLanguageCode",
                      "Unsupported language code error"
                    ],
                    [
                      "InvalidCountryHint",
                      "Invalid country hint error"
                    ]
                  ],
                  "old": [
                    [
                      "InvalidRequest",
                      ""
                    ],
                    [
                      "InvalidParameterValue",
                      ""
                    ],
                    [
                      "KnowledgeBaseNotFound",
                      ""
                    ],
                    [
                      "AzureCognitiveSearchNotFound",
                      ""
                    ],
                    [
                      "AzureCognitiveSearchThrottling",
                      ""
                    ],
                    [
                      "ExtractionFailure",
                      ""
                    ],
                    [
                      "InvalidRequestBodyFormat",
                      ""
                    ],
                    [
                      "EmptyRequest",
                      ""
                    ],
                    [
                      "MissingInputDocuments",
                      ""
                    ],
                    [
                      "InvalidDocument",
                      ""
                    ],
                    [
                      "ModelVersionIncorrect",
                      ""
                    ],
                    [
                      "InvalidDocumentBatch",
                      ""
                    ],
                    [
                      "UnsupportedLanguageCode",
                      ""
                    ],
                    [
                      "InvalidCountryHint",
                      ""
                    ]
                  ]
                }
              }
            ]
          }
        ]
      }
    }
  }
}

⚼ Request

DELETE:  /authoring/query-knowledgebases/projects/{projectName}
{
api-version:
{
Description: The API version to use for this operation. ,
Required: True ,
}
string ,
projectName:
{
Description: The name of the project to use. ,
Required: True ,
}
string ,
}

⚐ Response (202)

{
operation-location:
{
Description: The location for monitoring the operation state. ,
}
string ,
}

⚐ Response (default)

{
$headers:
{
x-ms-error-code:
{
Description: String error code indicating what went wrong. ,
}
string ,
}
,
$schema:
{
Description: Error response. ,
}
{
error:
{
Description: The error object. ,
Required: True ,
}
{
code:
{
Description: One of a server-defined set of error codes. ,
Enum:
{
InvalidRequest: Invalid request error ,
InvalidArgument: Invalid argument error ,
Unauthorized: Unauthorized access error ,
Forbidden: Forbidden access error ,
NotFound: Not found error ,
ProjectNotFound: Project not found error ,
OperationNotFound: Operation not found error ,
AzureCognitiveSearchNotFound: Azure Cognitive Search not found error ,
AzureCognitiveSearchIndexNotFound: Azure Cognitive Search index not found error ,
TooManyRequests: Too many requests error ,
AzureCognitiveSearchThrottling: Azure Cognitive Search throttling error ,
AzureCognitiveSearchIndexLimitReached: Azure Cognitive Search index limit reached error ,
InternalServerError: Internal server error ,
ServiceUnavailable: Service unavailable error ,
Timeout: Timeout error ,
QuotaExceeded: Quota exceeded error ,
Conflict: Conflict error ,
Warning: Warning error ,
}
,
Required: True ,
}
enum ,
message:
{
Description: A human-readable representation of the error. ,
Required: True ,
}
string ,
target:
{
Description: The target of the error. ,
Required: False ,
}
string ,
details:
{
Description: An array of details about specific errors that led to this reported error. ,
Required: False ,
}
[
string ,
]
,
innererror:
{
Description: An object containing more specific information than the current object about the error. ,
Required: False ,
}
{
code:
{
Description: One of a server-defined set of error codes. ,
Enum:
{
InvalidRequest: Invalid request error ,
InvalidParameterValue: Invalid parameter value error ,
KnowledgeBaseNotFound: Knowledge base not found error ,
AzureCognitiveSearchNotFound: Azure Cognitive Search not found error ,
AzureCognitiveSearchThrottling: Azure Cognitive Search throttling error ,
ExtractionFailure: Extraction failure error ,
InvalidRequestBodyFormat: Invalid request body format error ,
EmptyRequest: Empty request error ,
MissingInputDocuments: Missing input documents error ,
InvalidDocument: Invalid document error ,
ModelVersionIncorrect: Model version incorrect error ,
InvalidDocumentBatch: Invalid document batch error ,
UnsupportedLanguageCode: Unsupported language code error ,
InvalidCountryHint: Invalid country hint error ,
}
,
Required: True ,
}
enum ,
message:
{
Description: Error message. ,
Required: True ,
}
string ,
details:
{
Description: Error details. ,
Required: False ,
}
object ,
target:
{
Description: Error target. ,
Required: False ,
}
string ,
innererror:
{
Required: False ,
}
string ,
}
,
}
,
}
,
}
QuestionAnsweringProjects_Export (updated)
Description :  Export project metadata and assets.
Reference :  Link ¶

⚶ Changes

{
  "#id": "QuestionAnsweringProjects_Export",
  "$parameters": [
    {
      "#name": "api-version",
      "Description": {
        "new": "The API version to use for this operation.",
        "old": "Client API version."
      }
    }
  ],
  "$responses": {
    "default": {
      "$properties": {
        "error": [
          {
            "#name": "code",
            "Enum": {
              "new": [
                [
                  "InvalidRequest",
                  "Invalid request error"
                ],
                [
                  "InvalidArgument",
                  "Invalid argument error"
                ],
                [
                  "Unauthorized",
                  "Unauthorized access error"
                ],
                [
                  "Forbidden",
                  "Forbidden access error"
                ],
                [
                  "NotFound",
                  "Not found error"
                ],
                [
                  "ProjectNotFound",
                  "Project not found error"
                ],
                [
                  "OperationNotFound",
                  "Operation not found error"
                ],
                [
                  "AzureCognitiveSearchNotFound",
                  "Azure Cognitive Search not found error"
                ],
                [
                  "AzureCognitiveSearchIndexNotFound",
                  "Azure Cognitive Search index not found error"
                ],
                [
                  "TooManyRequests",
                  "Too many requests error"
                ],
                [
                  "AzureCognitiveSearchThrottling",
                  "Azure Cognitive Search throttling error"
                ],
                [
                  "AzureCognitiveSearchIndexLimitReached",
                  "Azure Cognitive Search index limit reached error"
                ],
                [
                  "InternalServerError",
                  "Internal server error"
                ],
                [
                  "ServiceUnavailable",
                  "Service unavailable error"
                ],
                [
                  "Timeout",
                  "Timeout error"
                ],
                [
                  "QuotaExceeded",
                  "Quota exceeded error"
                ],
                [
                  "Conflict",
                  "Conflict error"
                ],
                [
                  "Warning",
                  "Warning error"
                ]
              ],
              "old": [
                [
                  "InvalidRequest",
                  ""
                ],
                [
                  "InvalidArgument",
                  ""
                ],
                [
                  "Unauthorized",
                  ""
                ],
                [
                  "Forbidden",
                  ""
                ],
                [
                  "NotFound",
                  ""
                ],
                [
                  "ProjectNotFound",
                  ""
                ],
                [
                  "OperationNotFound",
                  ""
                ],
                [
                  "AzureCognitiveSearchNotFound",
                  ""
                ],
                [
                  "AzureCognitiveSearchIndexNotFound",
                  ""
                ],
                [
                  "TooManyRequests",
                  ""
                ],
                [
                  "AzureCognitiveSearchThrottling",
                  ""
                ],
                [
                  "AzureCognitiveSearchIndexLimitReached",
                  ""
                ],
                [
                  "InternalServerError",
                  ""
                ],
                [
                  "ServiceUnavailable",
                  ""
                ],
                [
                  "Timeout",
                  ""
                ],
                [
                  "QuotaExceeded",
                  ""
                ],
                [
                  "Conflict",
                  ""
                ],
                [
                  "Warning",
                  ""
                ]
              ]
            }
          },
          {
            "#name": "innererror",
            "Description": {
              "new": "An object containing more specific information than the current object about\nthe error.",
              "old": "An object containing more specific information than the current object about the error."
            },
            "$properties": [
              {
                "#name": "code",
                "Enum": {
                  "new": [
                    [
                      "InvalidRequest",
                      "Invalid request error"
                    ],
                    [
                      "InvalidParameterValue",
                      "Invalid parameter value error"
                    ],
                    [
                      "KnowledgeBaseNotFound",
                      "Knowledge base not found error"
                    ],
                    [
                      "AzureCognitiveSearchNotFound",
                      "Azure Cognitive Search not found error"
                    ],
                    [
                      "AzureCognitiveSearchThrottling",
                      "Azure Cognitive Search throttling error"
                    ],
                    [
                      "ExtractionFailure",
                      "Extraction failure error"
                    ],
                    [
                      "InvalidRequestBodyFormat",
                      "Invalid request body format error"
                    ],
                    [
                      "EmptyRequest",
                      "Empty request error"
                    ],
                    [
                      "MissingInputDocuments",
                      "Missing input documents error"
                    ],
                    [
                      "InvalidDocument",
                      "Invalid document error"
                    ],
                    [
                      "ModelVersionIncorrect",
                      "Model version incorrect error"
                    ],
                    [
                      "InvalidDocumentBatch",
                      "Invalid document batch error"
                    ],
                    [
                      "UnsupportedLanguageCode",
                      "Unsupported language code error"
                    ],
                    [
                      "InvalidCountryHint",
                      "Invalid country hint error"
                    ]
                  ],
                  "old": [
                    [
                      "InvalidRequest",
                      ""
                    ],
                    [
                      "InvalidParameterValue",
                      ""
                    ],
                    [
                      "KnowledgeBaseNotFound",
                      ""
                    ],
                    [
                      "AzureCognitiveSearchNotFound",
                      ""
                    ],
                    [
                      "AzureCognitiveSearchThrottling",
                      ""
                    ],
                    [
                      "ExtractionFailure",
                      ""
                    ],
                    [
                      "InvalidRequestBodyFormat",
                      ""
                    ],
                    [
                      "EmptyRequest",
                      ""
                    ],
                    [
                      "MissingInputDocuments",
                      ""
                    ],
                    [
                      "InvalidDocument",
                      ""
                    ],
                    [
                      "ModelVersionIncorrect",
                      ""
                    ],
                    [
                      "InvalidDocumentBatch",
                      ""
                    ],
                    [
                      "UnsupportedLanguageCode",
                      ""
                    ],
                    [
                      "InvalidCountryHint",
                      ""
                    ]
                  ]
                }
              }
            ]
          }
        ]
      }
    },
    "@removed_bbe12c01d7a444f38618ca8294e83949": {
      "200": {
        "Description": "Export job status, project metadata, and assets.",
        "Type": "string"
      }
    }
  }
}

⚼ Request

POST:  /authoring/query-knowledgebases/projects/{projectName}/:export
{
api-version:
{
Description: The API version to use for this operation. ,
Required: True ,
}
string ,
projectName:
{
Description: The name of the project to use. ,
Required: True ,
}
string ,
format:
{
Description: Knowledge base Import or Export format. ,
Required: False ,
}
string ,
assetKind:
{
Description: Kind of the asset of the project. ,
Required: False ,
}
string ,
}

⚐ Response (202)

{
operation-location:
{
Description: The location for monitoring the operation state. ,
}
string ,
}

⚐ Response (default)

{
$headers:
{
x-ms-error-code:
{
Description: String error code indicating what went wrong. ,
}
string ,
}
,
$schema:
{
Description: Error response. ,
}
{
error:
{
Description: The error object. ,
Required: True ,
}
{
code:
{
Description: One of a server-defined set of error codes. ,
Enum:
{
InvalidRequest: Invalid request error ,
InvalidArgument: Invalid argument error ,
Unauthorized: Unauthorized access error ,
Forbidden: Forbidden access error ,
NotFound: Not found error ,
ProjectNotFound: Project not found error ,
OperationNotFound: Operation not found error ,
AzureCognitiveSearchNotFound: Azure Cognitive Search not found error ,
AzureCognitiveSearchIndexNotFound: Azure Cognitive Search index not found error ,
TooManyRequests: Too many requests error ,
AzureCognitiveSearchThrottling: Azure Cognitive Search throttling error ,
AzureCognitiveSearchIndexLimitReached: Azure Cognitive Search index limit reached error ,
InternalServerError: Internal server error ,
ServiceUnavailable: Service unavailable error ,
Timeout: Timeout error ,
QuotaExceeded: Quota exceeded error ,
Conflict: Conflict error ,
Warning: Warning error ,
}
,
Required: True ,
}
enum ,
message:
{
Description: A human-readable representation of the error. ,
Required: True ,
}
string ,
target:
{
Description: The target of the error. ,
Required: False ,
}
string ,
details:
{
Description: An array of details about specific errors that led to this reported error. ,
Required: False ,
}
[
string ,
]
,
innererror:
{
Description: An object containing more specific information than the current object about the error. ,
Required: False ,
}
{
code:
{
Description: One of a server-defined set of error codes. ,
Enum:
{
InvalidRequest: Invalid request error ,
InvalidParameterValue: Invalid parameter value error ,
KnowledgeBaseNotFound: Knowledge base not found error ,
AzureCognitiveSearchNotFound: Azure Cognitive Search not found error ,
AzureCognitiveSearchThrottling: Azure Cognitive Search throttling error ,
ExtractionFailure: Extraction failure error ,
InvalidRequestBodyFormat: Invalid request body format error ,
EmptyRequest: Empty request error ,
MissingInputDocuments: Missing input documents error ,
InvalidDocument: Invalid document error ,
ModelVersionIncorrect: Model version incorrect error ,
InvalidDocumentBatch: Invalid document batch error ,
UnsupportedLanguageCode: Unsupported language code error ,
InvalidCountryHint: Invalid country hint error ,
}
,
Required: True ,
}
enum ,
message:
{
Description: Error message. ,
Required: True ,
}
string ,
details:
{
Description: Error details. ,
Required: False ,
}
object ,
target:
{
Description: Error target. ,
Required: False ,
}
string ,
innererror:
{
Required: False ,
}
string ,
}
,
}
,
}
,
}
QuestionAnsweringProjects_Import (updated)
Description :  Import project assets.
Reference :  Link ¶

⚶ Changes

{
  "#id": "QuestionAnsweringProjects_Import",
  "$parameters": [
    {
      "#name": "api-version",
      "Description": {
        "new": "The API version to use for this operation.",
        "old": "Client API version."
      }
    },
    {
      "body": {
        "$properties": {
          "metadata": [
            {
              "@added_b8f21f697ea74afa91ebd9185ed16537": {
                "#name": "projectName",
                "Description": "Name of the project.",
                "Required": true,
                "Type": "string"
              }
            },
            {
              "#name": "language",
              "Description": {
                "new": "Language of the text records. This is BCP-47 representation of a language. For\nexample, use \"en\" for English; \"es\" for Spanish etc. If not set, use \"en\" for\nEnglish as default.",
                "old": "Language of the text records. This is BCP-47 representation of a language. For example, use \"en\" for English; \"es\" for Spanish etc. If not set, use \"en\" for English as default."
              },
              "Required": {
                "new": false,
                "old": true
              }
            },
            {
              "#name": "multilingualResource",
              "Description": {
                "new": "Resource enabled for multiple languages across projects or not.",
                "old": "Set to true to enable creating knowledgebases in different languages for the same resource."
              }
            },
            {
              "@added_e24079ebe14a4ebfbb856c7d26ca9c00": {
                "#name": "createdDateTime",
                "Description": "Project creation date-time.",
                "Format": "date-time",
                "Required": false,
                "Type": "string"
              }
            },
            {
              "@added_187eb5d36db840509ff0fbb60194d594": {
                "#name": "lastModifiedDateTime",
                "Description": "Represents the project last modified date-time.",
                "Format": "date-time",
                "Required": false,
                "Type": "string"
              }
            },
            {
              "@added_37a16a5c4f05475b9e2f07f69f51c1e4": {
                "#name": "lastDeployedDateTime",
                "Description": "Represents the project last deployment date-time.",
                "Format": "date-time",
                "Required": false,
                "Type": "string"
              }
            }
          ],
          "assets": [
            {
              "qnas": {
                "Type": {
                  "new": "object",
                  "old": "string"
                }
              }
            }
          ]
        }
      }
    }
  ],
  "$responses": {
    "default": {
      "$properties": {
        "error": [
          {
            "#name": "code",
            "Enum": {
              "new": [
                [
                  "InvalidRequest",
                  "Invalid request error"
                ],
                [
                  "InvalidArgument",
                  "Invalid argument error"
                ],
                [
                  "Unauthorized",
                  "Unauthorized access error"
                ],
                [
                  "Forbidden",
                  "Forbidden access error"
                ],
                [
                  "NotFound",
                  "Not found error"
                ],
                [
                  "ProjectNotFound",
                  "Project not found error"
                ],
                [
                  "OperationNotFound",
                  "Operation not found error"
                ],
                [
                  "AzureCognitiveSearchNotFound",
                  "Azure Cognitive Search not found error"
                ],
                [
                  "AzureCognitiveSearchIndexNotFound",
                  "Azure Cognitive Search index not found error"
                ],
                [
                  "TooManyRequests",
                  "Too many requests error"
                ],
                [
                  "AzureCognitiveSearchThrottling",
                  "Azure Cognitive Search throttling error"
                ],
                [
                  "AzureCognitiveSearchIndexLimitReached",
                  "Azure Cognitive Search index limit reached error"
                ],
                [
                  "InternalServerError",
                  "Internal server error"
                ],
                [
                  "ServiceUnavailable",
                  "Service unavailable error"
                ],
                [
                  "Timeout",
                  "Timeout error"
                ],
                [
                  "QuotaExceeded",
                  "Quota exceeded error"
                ],
                [
                  "Conflict",
                  "Conflict error"
                ],
                [
                  "Warning",
                  "Warning error"
                ]
              ],
              "old": [
                [
                  "InvalidRequest",
                  ""
                ],
                [
                  "InvalidArgument",
                  ""
                ],
                [
                  "Unauthorized",
                  ""
                ],
                [
                  "Forbidden",
                  ""
                ],
                [
                  "NotFound",
                  ""
                ],
                [
                  "ProjectNotFound",
                  ""
                ],
                [
                  "OperationNotFound",
                  ""
                ],
                [
                  "AzureCognitiveSearchNotFound",
                  ""
                ],
                [
                  "AzureCognitiveSearchIndexNotFound",
                  ""
                ],
                [
                  "TooManyRequests",
                  ""
                ],
                [
                  "AzureCognitiveSearchThrottling",
                  ""
                ],
                [
                  "AzureCognitiveSearchIndexLimitReached",
                  ""
                ],
                [
                  "InternalServerError",
                  ""
                ],
                [
                  "ServiceUnavailable",
                  ""
                ],
                [
                  "Timeout",
                  ""
                ],
                [
                  "QuotaExceeded",
                  ""
                ],
                [
                  "Conflict",
                  ""
                ],
                [
                  "Warning",
                  ""
                ]
              ]
            }
          },
          {
            "#name": "innererror",
            "Description": {
              "new": "An object containing more specific information than the current object about\nthe error.",
              "old": "An object containing more specific information than the current object about the error."
            },
            "$properties": [
              {
                "#name": "code",
                "Enum": {
                  "new": [
                    [
                      "InvalidRequest",
                      "Invalid request error"
                    ],
                    [
                      "InvalidParameterValue",
                      "Invalid parameter value error"
                    ],
                    [
                      "KnowledgeBaseNotFound",
                      "Knowledge base not found error"
                    ],
                    [
                      "AzureCognitiveSearchNotFound",
                      "Azure Cognitive Search not found error"
                    ],
                    [
                      "AzureCognitiveSearchThrottling",
                      "Azure Cognitive Search throttling error"
                    ],
                    [
                      "ExtractionFailure",
                      "Extraction failure error"
                    ],
                    [
                      "InvalidRequestBodyFormat",
                      "Invalid request body format error"
                    ],
                    [
                      "EmptyRequest",
                      "Empty request error"
                    ],
                    [
                      "MissingInputDocuments",
                      "Missing input documents error"
                    ],
                    [
                      "InvalidDocument",
                      "Invalid document error"
                    ],
                    [
                      "ModelVersionIncorrect",
                      "Model version incorrect error"
                    ],
                    [
                      "InvalidDocumentBatch",
                      "Invalid document batch error"
                    ],
                    [
                      "UnsupportedLanguageCode",
                      "Unsupported language code error"
                    ],
                    [
                      "InvalidCountryHint",
                      "Invalid country hint error"
                    ]
                  ],
                  "old": [
                    [
                      "InvalidRequest",
                      ""
                    ],
                    [
                      "InvalidParameterValue",
                      ""
                    ],
                    [
                      "KnowledgeBaseNotFound",
                      ""
                    ],
                    [
                      "AzureCognitiveSearchNotFound",
                      ""
                    ],
                    [
                      "AzureCognitiveSearchThrottling",
                      ""
                    ],
                    [
                      "ExtractionFailure",
                      ""
                    ],
                    [
                      "InvalidRequestBodyFormat",
                      ""
                    ],
                    [
                      "EmptyRequest",
                      ""
                    ],
                    [
                      "MissingInputDocuments",
                      ""
                    ],
                    [
                      "InvalidDocument",
                      ""
                    ],
                    [
                      "ModelVersionIncorrect",
                      ""
                    ],
                    [
                      "InvalidDocumentBatch",
                      ""
                    ],
                    [
                      "UnsupportedLanguageCode",
                      ""
                    ],
                    [
                      "InvalidCountryHint",
                      ""
                    ]
                  ]
                }
              }
            ]
          }
        ]
      }
    }
  }
}

⚼ Request

POST:  /authoring/query-knowledgebases/projects/{projectName}/:import
{
api-version:
{
Description: The API version to use for this operation. ,
Required: True ,
}
string ,
projectName:
{
Description: The name of the project to use. ,
Required: True ,
}
string ,
format:
{
Description: Knowledge base Import or Export format. ,
Required: False ,
}
string ,
assetKind:
{
Description: Kind of the asset of the project. ,
Required: False ,
}
string ,
body:
{
Description: Project assets the needs to be imported. ,
Required: False ,
}
{
metadata:
{
Description: Parameters needed to create the project. ,
Required: False ,
}
{
projectName:
{
Description: Name of the project. ,
Required: True ,
}
string ,
description:
{
Description: Description of the project. ,
Required: False ,
}
string ,
language:
{
Description: Language of the text records. This is BCP-47 representation of a language. For example, use "en" for English; "es" for Spanish etc. If not set, use "en" for English as default. ,
Required: False ,
}
string ,
multilingualResource:
{
Description: Resource enabled for multiple languages across projects or not. ,
Required: False ,
}
boolean ,
settings:
{
Description: Configurable settings of the Project. ,
Required: False ,
}
{
defaultAnswer:
{
Description: Default Answer response when no good match is found in the knowledge base. ,
Required: False ,
}
string ,
}
,
createdDateTime:
{
Description: Project creation date-time. ,
Format: date-time ,
Required: False ,
}
string ,
lastModifiedDateTime:
{
Description: Represents the project last modified date-time. ,
Format: date-time ,
Required: False ,
}
string ,
lastDeployedDateTime:
{
Description: Represents the project last deployment date-time. ,
Format: date-time ,
Required: False ,
}
string ,
}
,
assets:
{
Description: All assets for this project. ,
Required: False ,
}
{
synonyms:
{
Description: Collection of synonyms. ,
Required: False ,
}
[
{
alterations:
{
Description: Collection of word alterations. ,
Required: True ,
}
[
string ,
]
,
}
,
]
,
qnas:
{
Description: List of QnA records to import. ,
Required: False ,
}
[
{
id:
{
Description: Unique ID for the QnA. ,
Format: int32 ,
Required: True ,
}
integer ,
answer:
{
Description: Answer text. ,
Required: False ,
}
string ,
source:
{
Description: Source from which QnA was indexed e.g. https://docs.microsoft.com/en-us/azure/cognitive-services/QnAMaker/FAQs . ,
Required: False ,
}
string ,
questions:
{
Description: List of questions associated with the answer. ,
Required: False ,
}
[
string ,
]
,
metadata:
{
Description: Metadata associated with the answer, useful to categorize or filter question answers. ,
Required: False ,
}
object ,
dialog:
{
Description: Context of a QnA. ,
Required: False ,
}
{
isContextOnly:
{
Description: To mark if a prompt is relevant only with a previous question or not. If true, do not include this QnA as answer for queries without context; otherwise, ignores context and includes this QnA in answers. ,
Required: False ,
}
boolean ,
prompts:
{
Description: List of prompts associated with the answer. ,
Required: False ,
}
[
{
displayOrder:
{
Description: Index of the prompt. It is used for ordering of the prompts. ,
Format: int32 ,
Required: False ,
}
integer ,
qnaId:
{
Description: ID of the QnA corresponding to the prompt. ,
Format: int32 ,
Required: False ,
}
integer ,
qna:
{
Description: QnA record. Either QnAId or QnA record needs to be present in a Prompt. ,
Required: False ,
}
{
id:
{
Description: Unique ID for the QnA. ,
Format: int32 ,
Required: True ,
}
integer ,
answer:
{
Description: Answer text. ,
Required: False ,
}
string ,
source:
{
Description: Source from which QnA was indexed e.g. https://docs.microsoft.com/en-us/azure/cognitive-services/QnAMaker/FAQs . ,
Required: False ,
}
string ,
questions:
{
Description: List of questions associated with the answer. ,
Required: False ,
}
[
string ,
]
,
metadata:
{
Description: Metadata associated with the answer, useful to categorize or filter question answers. ,
Required: False ,
}
object ,
dialog:
{
Required: False ,
}
string ,
activeLearningSuggestions:
{
Description: List of Active Learning suggestions for the QnA. ,
Required: False ,
}
[
{
clusterHead:
{
Description: Question chosen as the head of suggested questions cluster by Active Learning clustering algorithm. ,
Required: False ,
}
string ,
suggestedQuestions:
{
Description: List of all suggested questions for the QnA. ,
Required: False ,
}
[
{
question:
{
Description: Question suggested by the Active Learning feature. ,
Required: False ,
}
string ,
userSuggestedCount:
{
Description: The number of times the question was suggested explicitly by the user. ,
Format: int32 ,
Required: False ,
}
integer ,
autoSuggestedCount:
{
Description: The number of times the question was suggested automatically by the Active Learning algorithm. ,
Format: int32 ,
Required: False ,
}
integer ,
}
,
]
,
}
,
]
,
}
,
displayText:
{
Description: Text displayed to represent a follow up question prompt. ,
Required: False ,
}
string ,
}
,
]
,
}
,
activeLearningSuggestions:
{
Description: List of Active Learning suggestions for the QnA. ,
Required: False ,
}
[
{
clusterHead:
{
Description: Question chosen as the head of suggested questions cluster by Active Learning clustering algorithm. ,
Required: False ,
}
string ,
suggestedQuestions:
{
Description: List of all suggested questions for the QnA. ,
Required: False ,
}
[
{
question:
{
Description: Question suggested by the Active Learning feature. ,
Required: False ,
}
string ,
userSuggestedCount:
{
Description: The number of times the question was suggested explicitly by the user. ,
Format: int32 ,
Required: False ,
}
integer ,
autoSuggestedCount:
{
Description: The number of times the question was suggested automatically by the Active Learning algorithm. ,
Format: int32 ,
Required: False ,
}
integer ,
}
,
]
,
}
,
]
,
lastUpdatedDateTime:
{
Description: Date-time when the QnA was last updated. ,
Format: date-time ,
Required: False ,
}
string ,
sourceDisplayName:
{
Description: Friendly name of the Source. ,
Required: False ,
}
string ,
}
,
]
,
}
,
fileUri:
{
Description: Import data File URI. ,
Required: False ,
}
string ,
}
,
}

⚐ Response (202)

{
operation-location:
{
Description: The location for monitoring the operation state. ,
}
string ,
}

⚐ Response (default)

{
$headers:
{
x-ms-error-code:
{
Description: String error code indicating what went wrong. ,
}
string ,
}
,
$schema:
{
Description: Error response. ,
}
{
error:
{
Description: The error object. ,
Required: True ,
}
{
code:
{
Description: One of a server-defined set of error codes. ,
Enum:
{
InvalidRequest: Invalid request error ,
InvalidArgument: Invalid argument error ,
Unauthorized: Unauthorized access error ,
Forbidden: Forbidden access error ,
NotFound: Not found error ,
ProjectNotFound: Project not found error ,
OperationNotFound: Operation not found error ,
AzureCognitiveSearchNotFound: Azure Cognitive Search not found error ,
AzureCognitiveSearchIndexNotFound: Azure Cognitive Search index not found error ,
TooManyRequests: Too many requests error ,
AzureCognitiveSearchThrottling: Azure Cognitive Search throttling error ,
AzureCognitiveSearchIndexLimitReached: Azure Cognitive Search index limit reached error ,
InternalServerError: Internal server error ,
ServiceUnavailable: Service unavailable error ,
Timeout: Timeout error ,
QuotaExceeded: Quota exceeded error ,
Conflict: Conflict error ,
Warning: Warning error ,
}
,
Required: True ,
}
enum ,
message:
{
Description: A human-readable representation of the error. ,
Required: True ,
}
string ,
target:
{
Description: The target of the error. ,
Required: False ,
}
string ,
details:
{
Description: An array of details about specific errors that led to this reported error. ,
Required: False ,
}
[
string ,
]
,
innererror:
{
Description: An object containing more specific information than the current object about the error. ,
Required: False ,
}
{
code:
{
Description: One of a server-defined set of error codes. ,
Enum:
{
InvalidRequest: Invalid request error ,
InvalidParameterValue: Invalid parameter value error ,
KnowledgeBaseNotFound: Knowledge base not found error ,
AzureCognitiveSearchNotFound: Azure Cognitive Search not found error ,
AzureCognitiveSearchThrottling: Azure Cognitive Search throttling error ,
ExtractionFailure: Extraction failure error ,
InvalidRequestBodyFormat: Invalid request body format error ,
EmptyRequest: Empty request error ,
MissingInputDocuments: Missing input documents error ,
InvalidDocument: Invalid document error ,
ModelVersionIncorrect: Model version incorrect error ,
InvalidDocumentBatch: Invalid document batch error ,
UnsupportedLanguageCode: Unsupported language code error ,
InvalidCountryHint: Invalid country hint error ,
}
,
Required: True ,
}
enum ,
message:
{
Description: Error message. ,
Required: True ,
}
string ,
details:
{
Description: Error details. ,
Required: False ,
}
object ,
target:
{
Description: Error target. ,
Required: False ,
}
string ,
innererror:
{
Required: False ,
}
string ,
}
,
}
,
}
,
}
QuestionAnsweringProjects_ListDeployments (updated)
Description :  List all deployments of a project.
Reference :  Link ¶

⚶ Changes

{
  "#id": "QuestionAnsweringProjects_ListDeployments",
  "$parameters": [
    {
      "#name": "api-version",
      "Description": {
        "new": "The API version to use for this operation.",
        "old": "Client API version."
      }
    },
    {
      "#name": "projectName",
      "Description": {
        "new": "Name of the project.",
        "old": "The name of the project to use."
      }
    }
  ],
  "$responses": {
    "200": {
      "Description": {
        "new": "Paged collection of ProjectDeployment items",
        "old": "All deployments of a project."
      },
      "$properties": [
        {
          "#name": "value",
          "Description": {
            "new": "The ProjectDeployment items on this page",
            "old": "List of deployments of a project."
          },
          "Required": {
            "new": true,
            "old": false
          },
          "$items": {
            "$properties": [
              {
                "#name": "deploymentName",
                "Required": {
                  "new": true,
                  "old": false
                }
              }
            ]
          }
        }
      ]
    },
    "default": {
      "$properties": {
        "error": [
          {
            "#name": "code",
            "Enum": {
              "new": [
                [
                  "InvalidRequest",
                  "Invalid request error"
                ],
                [
                  "InvalidArgument",
                  "Invalid argument error"
                ],
                [
                  "Unauthorized",
                  "Unauthorized access error"
                ],
                [
                  "Forbidden",
                  "Forbidden access error"
                ],
                [
                  "NotFound",
                  "Not found error"
                ],
                [
                  "ProjectNotFound",
                  "Project not found error"
                ],
                [
                  "OperationNotFound",
                  "Operation not found error"
                ],
                [
                  "AzureCognitiveSearchNotFound",
                  "Azure Cognitive Search not found error"
                ],
                [
                  "AzureCognitiveSearchIndexNotFound",
                  "Azure Cognitive Search index not found error"
                ],
                [
                  "TooManyRequests",
                  "Too many requests error"
                ],
                [
                  "AzureCognitiveSearchThrottling",
                  "Azure Cognitive Search throttling error"
                ],
                [
                  "AzureCognitiveSearchIndexLimitReached",
                  "Azure Cognitive Search index limit reached error"
                ],
                [
                  "InternalServerError",
                  "Internal server error"
                ],
                [
                  "ServiceUnavailable",
                  "Service unavailable error"
                ],
                [
                  "Timeout",
                  "Timeout error"
                ],
                [
                  "QuotaExceeded",
                  "Quota exceeded error"
                ],
                [
                  "Conflict",
                  "Conflict error"
                ],
                [
                  "Warning",
                  "Warning error"
                ]
              ],
              "old": [
                [
                  "InvalidRequest",
                  ""
                ],
                [
                  "InvalidArgument",
                  ""
                ],
                [
                  "Unauthorized",
                  ""
                ],
                [
                  "Forbidden",
                  ""
                ],
                [
                  "NotFound",
                  ""
                ],
                [
                  "ProjectNotFound",
                  ""
                ],
                [
                  "OperationNotFound",
                  ""
                ],
                [
                  "AzureCognitiveSearchNotFound",
                  ""
                ],
                [
                  "AzureCognitiveSearchIndexNotFound",
                  ""
                ],
                [
                  "TooManyRequests",
                  ""
                ],
                [
                  "AzureCognitiveSearchThrottling",
                  ""
                ],
                [
                  "AzureCognitiveSearchIndexLimitReached",
                  ""
                ],
                [
                  "InternalServerError",
                  ""
                ],
                [
                  "ServiceUnavailable",
                  ""
                ],
                [
                  "Timeout",
                  ""
                ],
                [
                  "QuotaExceeded",
                  ""
                ],
                [
                  "Conflict",
                  ""
                ],
                [
                  "Warning",
                  ""
                ]
              ]
            }
          },
          {
            "#name": "innererror",
            "Description": {
              "new": "An object containing more specific information than the current object about\nthe error.",
              "old": "An object containing more specific information than the current object about the error."
            },
            "$properties": [
              {
                "#name": "code",
                "Enum": {
                  "new": [
                    [
                      "InvalidRequest",
                      "Invalid request error"
                    ],
                    [
                      "InvalidParameterValue",
                      "Invalid parameter value error"
                    ],
                    [
                      "KnowledgeBaseNotFound",
                      "Knowledge base not found error"
                    ],
                    [
                      "AzureCognitiveSearchNotFound",
                      "Azure Cognitive Search not found error"
                    ],
                    [
                      "AzureCognitiveSearchThrottling",
                      "Azure Cognitive Search throttling error"
                    ],
                    [
                      "ExtractionFailure",
                      "Extraction failure error"
                    ],
                    [
                      "InvalidRequestBodyFormat",
                      "Invalid request body format error"
                    ],
                    [
                      "EmptyRequest",
                      "Empty request error"
                    ],
                    [
                      "MissingInputDocuments",
                      "Missing input documents error"
                    ],
                    [
                      "InvalidDocument",
                      "Invalid document error"
                    ],
                    [
                      "ModelVersionIncorrect",
                      "Model version incorrect error"
                    ],
                    [
                      "InvalidDocumentBatch",
                      "Invalid document batch error"
                    ],
                    [
                      "UnsupportedLanguageCode",
                      "Unsupported language code error"
                    ],
                    [
                      "InvalidCountryHint",
                      "Invalid country hint error"
                    ]
                  ],
                  "old": [
                    [
                      "InvalidRequest",
                      ""
                    ],
                    [
                      "InvalidParameterValue",
                      ""
                    ],
                    [
                      "KnowledgeBaseNotFound",
                      ""
                    ],
                    [
                      "AzureCognitiveSearchNotFound",
                      ""
                    ],
                    [
                      "AzureCognitiveSearchThrottling",
                      ""
                    ],
                    [
                      "ExtractionFailure",
                      ""
                    ],
                    [
                      "InvalidRequestBodyFormat",
                      ""
                    ],
                    [
                      "EmptyRequest",
                      ""
                    ],
                    [
                      "MissingInputDocuments",
                      ""
                    ],
                    [
                      "InvalidDocument",
                      ""
                    ],
                    [
                      "ModelVersionIncorrect",
                      ""
                    ],
                    [
                      "InvalidDocumentBatch",
                      ""
                    ],
                    [
                      "UnsupportedLanguageCode",
                      ""
                    ],
                    [
                      "InvalidCountryHint",
                      ""
                    ]
                  ]
                }
              }
            ]
          }
        ]
      }
    }
  }
}

⚼ Request

GET:  /authoring/query-knowledgebases/projects/{projectName}/deployments
{
api-version:
{
Description: The API version to use for this operation. ,
Required: True ,
}
string ,
projectName:
{
Description: Name of the project. ,
Required: True ,
}
string ,
top:
{
Description: The maximum number of resources to return from the collection. ,
Format: int32 ,
Required: False ,
}
integer ,
skip:
{
Description: An offset into the collection of the first resource to be returned. ,
Format: int32 ,
Required: False ,
}
integer ,
maxpagesize:
{
Description: The maximum number of resources to include in a single response. ,
Format: int32 ,
Required: False ,
}
integer ,
}

⚐ Response (200)

{
value:
{
Description: The ProjectDeployment items on this page ,
Required: True ,
}
[
{
deploymentName:
{
Description: Name of the deployment. ,
Required: True ,
}
string ,
lastDeployedDateTime:
{
Description: Represents the project last deployment date-time. ,
Format: date-time ,
Required: False ,
}
string ,
}
,
]
,
nextLink:
{
Description: The link to the next page of items ,
Format: uri ,
Required: False ,
}
string ,
}

⚐ Response (default)

{
$headers:
{
x-ms-error-code:
{
Description: String error code indicating what went wrong. ,
}
string ,
}
,
$schema:
{
Description: Error response. ,
}
{
error:
{
Description: The error object. ,
Required: True ,
}
{
code:
{
Description: One of a server-defined set of error codes. ,
Enum:
{
InvalidRequest: Invalid request error ,
InvalidArgument: Invalid argument error ,
Unauthorized: Unauthorized access error ,
Forbidden: Forbidden access error ,
NotFound: Not found error ,
ProjectNotFound: Project not found error ,
OperationNotFound: Operation not found error ,
AzureCognitiveSearchNotFound: Azure Cognitive Search not found error ,
AzureCognitiveSearchIndexNotFound: Azure Cognitive Search index not found error ,
TooManyRequests: Too many requests error ,
AzureCognitiveSearchThrottling: Azure Cognitive Search throttling error ,
AzureCognitiveSearchIndexLimitReached: Azure Cognitive Search index limit reached error ,
InternalServerError: Internal server error ,
ServiceUnavailable: Service unavailable error ,
Timeout: Timeout error ,
QuotaExceeded: Quota exceeded error ,
Conflict: Conflict error ,
Warning: Warning error ,
}
,
Required: True ,
}
enum ,
message:
{
Description: A human-readable representation of the error. ,
Required: True ,
}
string ,
target:
{
Description: The target of the error. ,
Required: False ,
}
string ,
details:
{
Description: An array of details about specific errors that led to this reported error. ,
Required: False ,
}
[
string ,
]
,
innererror:
{
Description: An object containing more specific information than the current object about the error. ,
Required: False ,
}
{
code:
{
Description: One of a server-defined set of error codes. ,
Enum:
{
InvalidRequest: Invalid request error ,
InvalidParameterValue: Invalid parameter value error ,
KnowledgeBaseNotFound: Knowledge base not found error ,
AzureCognitiveSearchNotFound: Azure Cognitive Search not found error ,
AzureCognitiveSearchThrottling: Azure Cognitive Search throttling error ,
ExtractionFailure: Extraction failure error ,
InvalidRequestBodyFormat: Invalid request body format error ,
EmptyRequest: Empty request error ,
MissingInputDocuments: Missing input documents error ,
InvalidDocument: Invalid document error ,
ModelVersionIncorrect: Model version incorrect error ,
InvalidDocumentBatch: Invalid document batch error ,
UnsupportedLanguageCode: Unsupported language code error ,
InvalidCountryHint: Invalid country hint error ,
}
,
Required: True ,
}
enum ,
message:
{
Description: Error message. ,
Required: True ,
}
string ,
details:
{
Description: Error details. ,
Required: False ,
}
object ,
target:
{
Description: Error target. ,
Required: False ,
}
string ,
innererror:
{
Required: False ,
}
string ,
}
,
}
,
}
,
}
QuestionAnsweringProjects_DeployProject (updated)
Description :  Deploy project to production.
Reference :  Link ¶

⚶ Changes

{
  "#id": "QuestionAnsweringProjects_DeployProject",
  "$parameters": [
    {
      "#name": "api-version",
      "Description": {
        "new": "The API version to use for this operation.",
        "old": "Client API version."
      }
    }
  ],
  "$responses": {
    "default": {
      "$properties": {
        "error": [
          {
            "#name": "code",
            "Enum": {
              "new": [
                [
                  "InvalidRequest",
                  "Invalid request error"
                ],
                [
                  "InvalidArgument",
                  "Invalid argument error"
                ],
                [
                  "Unauthorized",
                  "Unauthorized access error"
                ],
                [
                  "Forbidden",
                  "Forbidden access error"
                ],
                [
                  "NotFound",
                  "Not found error"
                ],
                [
                  "ProjectNotFound",
                  "Project not found error"
                ],
                [
                  "OperationNotFound",
                  "Operation not found error"
                ],
                [
                  "AzureCognitiveSearchNotFound",
                  "Azure Cognitive Search not found error"
                ],
                [
                  "AzureCognitiveSearchIndexNotFound",
                  "Azure Cognitive Search index not found error"
                ],
                [
                  "TooManyRequests",
                  "Too many requests error"
                ],
                [
                  "AzureCognitiveSearchThrottling",
                  "Azure Cognitive Search throttling error"
                ],
                [
                  "AzureCognitiveSearchIndexLimitReached",
                  "Azure Cognitive Search index limit reached error"
                ],
                [
                  "InternalServerError",
                  "Internal server error"
                ],
                [
                  "ServiceUnavailable",
                  "Service unavailable error"
                ],
                [
                  "Timeout",
                  "Timeout error"
                ],
                [
                  "QuotaExceeded",
                  "Quota exceeded error"
                ],
                [
                  "Conflict",
                  "Conflict error"
                ],
                [
                  "Warning",
                  "Warning error"
                ]
              ],
              "old": [
                [
                  "InvalidRequest",
                  ""
                ],
                [
                  "InvalidArgument",
                  ""
                ],
                [
                  "Unauthorized",
                  ""
                ],
                [
                  "Forbidden",
                  ""
                ],
                [
                  "NotFound",
                  ""
                ],
                [
                  "ProjectNotFound",
                  ""
                ],
                [
                  "OperationNotFound",
                  ""
                ],
                [
                  "AzureCognitiveSearchNotFound",
                  ""
                ],
                [
                  "AzureCognitiveSearchIndexNotFound",
                  ""
                ],
                [
                  "TooManyRequests",
                  ""
                ],
                [
                  "AzureCognitiveSearchThrottling",
                  ""
                ],
                [
                  "AzureCognitiveSearchIndexLimitReached",
                  ""
                ],
                [
                  "InternalServerError",
                  ""
                ],
                [
                  "ServiceUnavailable",
                  ""
                ],
                [
                  "Timeout",
                  ""
                ],
                [
                  "QuotaExceeded",
                  ""
                ],
                [
                  "Conflict",
                  ""
                ],
                [
                  "Warning",
                  ""
                ]
              ]
            }
          },
          {
            "#name": "innererror",
            "Description": {
              "new": "An object containing more specific information than the current object about\nthe error.",
              "old": "An object containing more specific information than the current object about the error."
            },
            "$properties": [
              {
                "#name": "code",
                "Enum": {
                  "new": [
                    [
                      "InvalidRequest",
                      "Invalid request error"
                    ],
                    [
                      "InvalidParameterValue",
                      "Invalid parameter value error"
                    ],
                    [
                      "KnowledgeBaseNotFound",
                      "Knowledge base not found error"
                    ],
                    [
                      "AzureCognitiveSearchNotFound",
                      "Azure Cognitive Search not found error"
                    ],
                    [
                      "AzureCognitiveSearchThrottling",
                      "Azure Cognitive Search throttling error"
                    ],
                    [
                      "ExtractionFailure",
                      "Extraction failure error"
                    ],
                    [
                      "InvalidRequestBodyFormat",
                      "Invalid request body format error"
                    ],
                    [
                      "EmptyRequest",
                      "Empty request error"
                    ],
                    [
                      "MissingInputDocuments",
                      "Missing input documents error"
                    ],
                    [
                      "InvalidDocument",
                      "Invalid document error"
                    ],
                    [
                      "ModelVersionIncorrect",
                      "Model version incorrect error"
                    ],
                    [
                      "InvalidDocumentBatch",
                      "Invalid document batch error"
                    ],
                    [
                      "UnsupportedLanguageCode",
                      "Unsupported language code error"
                    ],
                    [
                      "InvalidCountryHint",
                      "Invalid country hint error"
                    ]
                  ],
                  "old": [
                    [
                      "InvalidRequest",
                      ""
                    ],
                    [
                      "InvalidParameterValue",
                      ""
                    ],
                    [
                      "KnowledgeBaseNotFound",
                      ""
                    ],
                    [
                      "AzureCognitiveSearchNotFound",
                      ""
                    ],
                    [
                      "AzureCognitiveSearchThrottling",
                      ""
                    ],
                    [
                      "ExtractionFailure",
                      ""
                    ],
                    [
                      "InvalidRequestBodyFormat",
                      ""
                    ],
                    [
                      "EmptyRequest",
                      ""
                    ],
                    [
                      "MissingInputDocuments",
                      ""
                    ],
                    [
                      "InvalidDocument",
                      ""
                    ],
                    [
                      "ModelVersionIncorrect",
                      ""
                    ],
                    [
                      "InvalidDocumentBatch",
                      ""
                    ],
                    [
                      "UnsupportedLanguageCode",
                      ""
                    ],
                    [
                      "InvalidCountryHint",
                      ""
                    ]
                  ]
                }
              }
            ]
          }
        ]
      }
    }
  }
}

⚼ Request

PUT:  /authoring/query-knowledgebases/projects/{projectName}/deployments/{deploymentName}
{
api-version:
{
Description: The API version to use for this operation. ,
Required: True ,
}
string ,
projectName:
{
Description: The name of the project to use. ,
Required: True ,
}
string ,
deploymentName:
{
Description: The name of the specific deployment of the project to use. ,
Required: True ,
}
string ,
}

⚐ Response (202)

{
operation-location:
{
Description: The location for monitoring the operation state. ,
}
string ,
}

⚐ Response (default)

{
$headers:
{
x-ms-error-code:
{
Description: String error code indicating what went wrong. ,
}
string ,
}
,
$schema:
{
Description: Error response. ,
}
{
error:
{
Description: The error object. ,
Required: True ,
}
{
code:
{
Description: One of a server-defined set of error codes. ,
Enum:
{
InvalidRequest: Invalid request error ,
InvalidArgument: Invalid argument error ,
Unauthorized: Unauthorized access error ,
Forbidden: Forbidden access error ,
NotFound: Not found error ,
ProjectNotFound: Project not found error ,
OperationNotFound: Operation not found error ,
AzureCognitiveSearchNotFound: Azure Cognitive Search not found error ,
AzureCognitiveSearchIndexNotFound: Azure Cognitive Search index not found error ,
TooManyRequests: Too many requests error ,
AzureCognitiveSearchThrottling: Azure Cognitive Search throttling error ,
AzureCognitiveSearchIndexLimitReached: Azure Cognitive Search index limit reached error ,
InternalServerError: Internal server error ,
ServiceUnavailable: Service unavailable error ,
Timeout: Timeout error ,
QuotaExceeded: Quota exceeded error ,
Conflict: Conflict error ,
Warning: Warning error ,
}
,
Required: True ,
}
enum ,
message:
{
Description: A human-readable representation of the error. ,
Required: True ,
}
string ,
target:
{
Description: The target of the error. ,
Required: False ,
}
string ,
details:
{
Description: An array of details about specific errors that led to this reported error. ,
Required: False ,
}
[
string ,
]
,
innererror:
{
Description: An object containing more specific information than the current object about the error. ,
Required: False ,
}
{
code:
{
Description: One of a server-defined set of error codes. ,
Enum:
{
InvalidRequest: Invalid request error ,
InvalidParameterValue: Invalid parameter value error ,
KnowledgeBaseNotFound: Knowledge base not found error ,
AzureCognitiveSearchNotFound: Azure Cognitive Search not found error ,
AzureCognitiveSearchThrottling: Azure Cognitive Search throttling error ,
ExtractionFailure: Extraction failure error ,
InvalidRequestBodyFormat: Invalid request body format error ,
EmptyRequest: Empty request error ,
MissingInputDocuments: Missing input documents error ,
InvalidDocument: Invalid document error ,
ModelVersionIncorrect: Model version incorrect error ,
InvalidDocumentBatch: Invalid document batch error ,
UnsupportedLanguageCode: Unsupported language code error ,
InvalidCountryHint: Invalid country hint error ,
}
,
Required: True ,
}
enum ,
message:
{
Description: Error message. ,
Required: True ,
}
string ,
details:
{
Description: Error details. ,
Required: False ,
}
object ,
target:
{
Description: Error target. ,
Required: False ,
}
string ,
innererror:
{
Required: False ,
}
string ,
}
,
}
,
}
,
}
QuestionAnsweringProjects_GetDeployStatus (updated)
Description :  Gets the status of a Deploy job.
Reference :  Link ¶

⚶ Changes

{
  "#id": "QuestionAnsweringProjects_GetDeployStatus",
  "$parameters": [
    {
      "#name": "api-version",
      "Description": {
        "new": "The API version to use for this operation.",
        "old": "Client API version."
      }
    },
    {
      "#name": "projectName",
      "Description": {
        "new": "Name of the project.",
        "old": "The name of the project to use."
      }
    },
    {
      "#name": "deploymentName",
      "Description": {
        "new": "Name of the deployment.",
        "old": "The name of the specific deployment of the project to use."
      }
    },
    {
      "#name": "jobId",
      "Description": {
        "new": "The job ID.",
        "old": "Job ID."
      }
    }
  ],
  "$responses": {
    "200": {
      "Type": {
        "new": "object",
        "old": "string"
      }
    },
    "default": {
      "$properties": {
        "error": [
          {
            "#name": "code",
            "Enum": {
              "new": [
                [
                  "InvalidRequest",
                  "Invalid request error"
                ],
                [
                  "InvalidArgument",
                  "Invalid argument error"
                ],
                [
                  "Unauthorized",
                  "Unauthorized access error"
                ],
                [
                  "Forbidden",
                  "Forbidden access error"
                ],
                [
                  "NotFound",
                  "Not found error"
                ],
                [
                  "ProjectNotFound",
                  "Project not found error"
                ],
                [
                  "OperationNotFound",
                  "Operation not found error"
                ],
                [
                  "AzureCognitiveSearchNotFound",
                  "Azure Cognitive Search not found error"
                ],
                [
                  "AzureCognitiveSearchIndexNotFound",
                  "Azure Cognitive Search index not found error"
                ],
                [
                  "TooManyRequests",
                  "Too many requests error"
                ],
                [
                  "AzureCognitiveSearchThrottling",
                  "Azure Cognitive Search throttling error"
                ],
                [
                  "AzureCognitiveSearchIndexLimitReached",
                  "Azure Cognitive Search index limit reached error"
                ],
                [
                  "InternalServerError",
                  "Internal server error"
                ],
                [
                  "ServiceUnavailable",
                  "Service unavailable error"
                ],
                [
                  "Timeout",
                  "Timeout error"
                ],
                [
                  "QuotaExceeded",
                  "Quota exceeded error"
                ],
                [
                  "Conflict",
                  "Conflict error"
                ],
                [
                  "Warning",
                  "Warning error"
                ]
              ],
              "old": [
                [
                  "InvalidRequest",
                  ""
                ],
                [
                  "InvalidArgument",
                  ""
                ],
                [
                  "Unauthorized",
                  ""
                ],
                [
                  "Forbidden",
                  ""
                ],
                [
                  "NotFound",
                  ""
                ],
                [
                  "ProjectNotFound",
                  ""
                ],
                [
                  "OperationNotFound",
                  ""
                ],
                [
                  "AzureCognitiveSearchNotFound",
                  ""
                ],
                [
                  "AzureCognitiveSearchIndexNotFound",
                  ""
                ],
                [
                  "TooManyRequests",
                  ""
                ],
                [
                  "AzureCognitiveSearchThrottling",
                  ""
                ],
                [
                  "AzureCognitiveSearchIndexLimitReached",
                  ""
                ],
                [
                  "InternalServerError",
                  ""
                ],
                [
                  "ServiceUnavailable",
                  ""
                ],
                [
                  "Timeout",
                  ""
                ],
                [
                  "QuotaExceeded",
                  ""
                ],
                [
                  "Conflict",
                  ""
                ],
                [
                  "Warning",
                  ""
                ]
              ]
            }
          },
          {
            "#name": "innererror",
            "Description": {
              "new": "An object containing more specific information than the current object about\nthe error.",
              "old": "An object containing more specific information than the current object about the error."
            },
            "$properties": [
              {
                "#name": "code",
                "Enum": {
                  "new": [
                    [
                      "InvalidRequest",
                      "Invalid request error"
                    ],
                    [
                      "InvalidParameterValue",
                      "Invalid parameter value error"
                    ],
                    [
                      "KnowledgeBaseNotFound",
                      "Knowledge base not found error"
                    ],
                    [
                      "AzureCognitiveSearchNotFound",
                      "Azure Cognitive Search not found error"
                    ],
                    [
                      "AzureCognitiveSearchThrottling",
                      "Azure Cognitive Search throttling error"
                    ],
                    [
                      "ExtractionFailure",
                      "Extraction failure error"
                    ],
                    [
                      "InvalidRequestBodyFormat",
                      "Invalid request body format error"
                    ],
                    [
                      "EmptyRequest",
                      "Empty request error"
                    ],
                    [
                      "MissingInputDocuments",
                      "Missing input documents error"
                    ],
                    [
                      "InvalidDocument",
                      "Invalid document error"
                    ],
                    [
                      "ModelVersionIncorrect",
                      "Model version incorrect error"
                    ],
                    [
                      "InvalidDocumentBatch",
                      "Invalid document batch error"
                    ],
                    [
                      "UnsupportedLanguageCode",
                      "Unsupported language code error"
                    ],
                    [
                      "InvalidCountryHint",
                      "Invalid country hint error"
                    ]
                  ],
                  "old": [
                    [
                      "InvalidRequest",
                      ""
                    ],
                    [
                      "InvalidParameterValue",
                      ""
                    ],
                    [
                      "KnowledgeBaseNotFound",
                      ""
                    ],
                    [
                      "AzureCognitiveSearchNotFound",
                      ""
                    ],
                    [
                      "AzureCognitiveSearchThrottling",
                      ""
                    ],
                    [
                      "ExtractionFailure",
                      ""
                    ],
                    [
                      "InvalidRequestBodyFormat",
                      ""
                    ],
                    [
                      "EmptyRequest",
                      ""
                    ],
                    [
                      "MissingInputDocuments",
                      ""
                    ],
                    [
                      "InvalidDocument",
                      ""
                    ],
                    [
                      "ModelVersionIncorrect",
                      ""
                    ],
                    [
                      "InvalidDocumentBatch",
                      ""
                    ],
                    [
                      "UnsupportedLanguageCode",
                      ""
                    ],
                    [
                      "InvalidCountryHint",
                      ""
                    ]
                  ]
                }
              }
            ]
          }
        ]
      }
    }
  }
}

⚼ Request

GET:  /authoring/query-knowledgebases/projects/{projectName}/deployments/{deploymentName}/jobs/{jobId}
{
api-version:
{
Description: The API version to use for this operation. ,
Required: True ,
}
string ,
projectName:
{
Description: Name of the project. ,
Required: True ,
}
string ,
deploymentName:
{
Description: Name of the deployment. ,
Required: True ,
}
string ,
jobId:
{
Description: The job ID. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
createdDateTime:
{
Description: The creation date time of the job. ,
Format: date-time ,
Required: True ,
}
string ,
expirationDateTime:
{
Description: The expiration date time of the job. ,
Format: date-time ,
Required: False ,
}
string ,
jobId:
{
Description: The job ID. ,
Required: True ,
}
string ,
lastUpdatedDateTime:
{
Description: The last date time the job was updated. ,
Format: date-time ,
Required: True ,
}
string ,
status:
{
Description: Job Status. ,
Enum:
{
notStarted: No description available. ,
running: No description available. ,
succeeded: No description available. ,
failed: No description available. ,
cancelled: No description available. ,
cancelling: No description available. ,
partiallyCompleted: No description available. ,
}
,
Required: True ,
}
enum ,
errors:
{
Description: The errors encountered while executing the job. ,
Required: False ,
}
[
{
code:
{
Description: One of a server-defined set of error codes. ,
Required: True ,
}
string ,
message:
{
Description: A human-readable representation of the error. ,
Required: True ,
}
string ,
target:
{
Description: The target of the error. ,
Required: False ,
}
string ,
details:
{
Description: An array of details about specific errors that led to this reported error. ,
Required: False ,
}
[
string ,
]
,
innererror:
{
Description: An object containing more specific information than the current object about the error. ,
Required: False ,
}
{
code:
{
Description: One of a server-defined set of error codes. ,
Required: False ,
}
string ,
innererror:
{
Required: False ,
}
string ,
}
,
}
,
]
,
}

⚐ Response (default)

{
$headers:
{
x-ms-error-code:
{
Description: String error code indicating what went wrong. ,
}
string ,
}
,
$schema:
{
Description: Error response. ,
}
{
error:
{
Description: The error object. ,
Required: True ,
}
{
code:
{
Description: One of a server-defined set of error codes. ,
Enum:
{
InvalidRequest: Invalid request error ,
InvalidArgument: Invalid argument error ,
Unauthorized: Unauthorized access error ,
Forbidden: Forbidden access error ,
NotFound: Not found error ,
ProjectNotFound: Project not found error ,
OperationNotFound: Operation not found error ,
AzureCognitiveSearchNotFound: Azure Cognitive Search not found error ,
AzureCognitiveSearchIndexNotFound: Azure Cognitive Search index not found error ,
TooManyRequests: Too many requests error ,
AzureCognitiveSearchThrottling: Azure Cognitive Search throttling error ,
AzureCognitiveSearchIndexLimitReached: Azure Cognitive Search index limit reached error ,
InternalServerError: Internal server error ,
ServiceUnavailable: Service unavailable error ,
Timeout: Timeout error ,
QuotaExceeded: Quota exceeded error ,
Conflict: Conflict error ,
Warning: Warning error ,
}
,
Required: True ,
}
enum ,
message:
{
Description: A human-readable representation of the error. ,
Required: True ,
}
string ,
target:
{
Description: The target of the error. ,
Required: False ,
}
string ,
details:
{
Description: An array of details about specific errors that led to this reported error. ,
Required: False ,
}
[
string ,
]
,
innererror:
{
Description: An object containing more specific information than the current object about the error. ,
Required: False ,
}
{
code:
{
Description: One of a server-defined set of error codes. ,
Enum:
{
InvalidRequest: Invalid request error ,
InvalidParameterValue: Invalid parameter value error ,
KnowledgeBaseNotFound: Knowledge base not found error ,
AzureCognitiveSearchNotFound: Azure Cognitive Search not found error ,
AzureCognitiveSearchThrottling: Azure Cognitive Search throttling error ,
ExtractionFailure: Extraction failure error ,
InvalidRequestBodyFormat: Invalid request body format error ,
EmptyRequest: Empty request error ,
MissingInputDocuments: Missing input documents error ,
InvalidDocument: Invalid document error ,
ModelVersionIncorrect: Model version incorrect error ,
InvalidDocumentBatch: Invalid document batch error ,
UnsupportedLanguageCode: Unsupported language code error ,
InvalidCountryHint: Invalid country hint error ,
}
,
Required: True ,
}
enum ,
message:
{
Description: Error message. ,
Required: True ,
}
string ,
details:
{
Description: Error details. ,
Required: False ,
}
object ,
target:
{
Description: Error target. ,
Required: False ,
}
string ,
innererror:
{
Required: False ,
}
string ,
}
,
}
,
}
,
}
QuestionAnsweringProjects_GetExportStatus (updated)
Description :  Gets the status of an Export job, once job completes, returns the project metadata, and assets.
Reference :  Link ¶

⚶ Changes

{
  "#id": "QuestionAnsweringProjects_GetExportStatus",
  "$parameters": [
    {
      "#name": "api-version",
      "Description": {
        "new": "The API version to use for this operation.",
        "old": "Client API version."
      }
    },
    {
      "#name": "projectName",
      "Description": {
        "new": "Name of the project.",
        "old": "The name of the project to use."
      }
    },
    {
      "#name": "jobId",
      "Description": {
        "new": "The job ID.",
        "old": "Job ID."
      }
    }
  ],
  "$responses": {
    "200": {
      "Type": {
        "new": "object",
        "old": "string"
      }
    },
    "default": {
      "$properties": {
        "error": [
          {
            "#name": "code",
            "Enum": {
              "new": [
                [
                  "InvalidRequest",
                  "Invalid request error"
                ],
                [
                  "InvalidArgument",
                  "Invalid argument error"
                ],
                [
                  "Unauthorized",
                  "Unauthorized access error"
                ],
                [
                  "Forbidden",
                  "Forbidden access error"
                ],
                [
                  "NotFound",
                  "Not found error"
                ],
                [
                  "ProjectNotFound",
                  "Project not found error"
                ],
                [
                  "OperationNotFound",
                  "Operation not found error"
                ],
                [
                  "AzureCognitiveSearchNotFound",
                  "Azure Cognitive Search not found error"
                ],
                [
                  "AzureCognitiveSearchIndexNotFound",
                  "Azure Cognitive Search index not found error"
                ],
                [
                  "TooManyRequests",
                  "Too many requests error"
                ],
                [
                  "AzureCognitiveSearchThrottling",
                  "Azure Cognitive Search throttling error"
                ],
                [
                  "AzureCognitiveSearchIndexLimitReached",
                  "Azure Cognitive Search index limit reached error"
                ],
                [
                  "InternalServerError",
                  "Internal server error"
                ],
                [
                  "ServiceUnavailable",
                  "Service unavailable error"
                ],
                [
                  "Timeout",
                  "Timeout error"
                ],
                [
                  "QuotaExceeded",
                  "Quota exceeded error"
                ],
                [
                  "Conflict",
                  "Conflict error"
                ],
                [
                  "Warning",
                  "Warning error"
                ]
              ],
              "old": [
                [
                  "InvalidRequest",
                  ""
                ],
                [
                  "InvalidArgument",
                  ""
                ],
                [
                  "Unauthorized",
                  ""
                ],
                [
                  "Forbidden",
                  ""
                ],
                [
                  "NotFound",
                  ""
                ],
                [
                  "ProjectNotFound",
                  ""
                ],
                [
                  "OperationNotFound",
                  ""
                ],
                [
                  "AzureCognitiveSearchNotFound",
                  ""
                ],
                [
                  "AzureCognitiveSearchIndexNotFound",
                  ""
                ],
                [
                  "TooManyRequests",
                  ""
                ],
                [
                  "AzureCognitiveSearchThrottling",
                  ""
                ],
                [
                  "AzureCognitiveSearchIndexLimitReached",
                  ""
                ],
                [
                  "InternalServerError",
                  ""
                ],
                [
                  "ServiceUnavailable",
                  ""
                ],
                [
                  "Timeout",
                  ""
                ],
                [
                  "QuotaExceeded",
                  ""
                ],
                [
                  "Conflict",
                  ""
                ],
                [
                  "Warning",
                  ""
                ]
              ]
            }
          },
          {
            "#name": "innererror",
            "Description": {
              "new": "An object containing more specific information than the current object about\nthe error.",
              "old": "An object containing more specific information than the current object about the error."
            },
            "$properties": [
              {
                "#name": "code",
                "Enum": {
                  "new": [
                    [
                      "InvalidRequest",
                      "Invalid request error"
                    ],
                    [
                      "InvalidParameterValue",
                      "Invalid parameter value error"
                    ],
                    [
                      "KnowledgeBaseNotFound",
                      "Knowledge base not found error"
                    ],
                    [
                      "AzureCognitiveSearchNotFound",
                      "Azure Cognitive Search not found error"
                    ],
                    [
                      "AzureCognitiveSearchThrottling",
                      "Azure Cognitive Search throttling error"
                    ],
                    [
                      "ExtractionFailure",
                      "Extraction failure error"
                    ],
                    [
                      "InvalidRequestBodyFormat",
                      "Invalid request body format error"
                    ],
                    [
                      "EmptyRequest",
                      "Empty request error"
                    ],
                    [
                      "MissingInputDocuments",
                      "Missing input documents error"
                    ],
                    [
                      "InvalidDocument",
                      "Invalid document error"
                    ],
                    [
                      "ModelVersionIncorrect",
                      "Model version incorrect error"
                    ],
                    [
                      "InvalidDocumentBatch",
                      "Invalid document batch error"
                    ],
                    [
                      "UnsupportedLanguageCode",
                      "Unsupported language code error"
                    ],
                    [
                      "InvalidCountryHint",
                      "Invalid country hint error"
                    ]
                  ],
                  "old": [
                    [
                      "InvalidRequest",
                      ""
                    ],
                    [
                      "InvalidParameterValue",
                      ""
                    ],
                    [
                      "KnowledgeBaseNotFound",
                      ""
                    ],
                    [
                      "AzureCognitiveSearchNotFound",
                      ""
                    ],
                    [
                      "AzureCognitiveSearchThrottling",
                      ""
                    ],
                    [
                      "ExtractionFailure",
                      ""
                    ],
                    [
                      "InvalidRequestBodyFormat",
                      ""
                    ],
                    [
                      "EmptyRequest",
                      ""
                    ],
                    [
                      "MissingInputDocuments",
                      ""
                    ],
                    [
                      "InvalidDocument",
                      ""
                    ],
                    [
                      "ModelVersionIncorrect",
                      ""
                    ],
                    [
                      "InvalidDocumentBatch",
                      ""
                    ],
                    [
                      "UnsupportedLanguageCode",
                      ""
                    ],
                    [
                      "InvalidCountryHint",
                      ""
                    ]
                  ]
                }
              }
            ]
          }
        ]
      }
    }
  }
}

⚼ Request

GET:  /authoring/query-knowledgebases/projects/{projectName}/export/jobs/{jobId}
{
api-version:
{
Description: The API version to use for this operation. ,
Required: True ,
}
string ,
projectName:
{
Description: Name of the project. ,
Required: True ,
}
string ,
jobId:
{
Description: The job ID. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
createdDateTime:
{
Description: The creation date time of the job. ,
Format: date-time ,
Required: True ,
}
string ,
expirationDateTime:
{
Description: The expiration date time of the job. ,
Format: date-time ,
Required: False ,
}
string ,
jobId:
{
Description: The job ID. ,
Required: True ,
}
string ,
lastUpdatedDateTime:
{
Description: The last date time the job was updated. ,
Format: date-time ,
Required: True ,
}
string ,
status:
{
Description: Job Status. ,
Enum:
{
notStarted: No description available. ,
running: No description available. ,
succeeded: No description available. ,
failed: No description available. ,
cancelled: No description available. ,
cancelling: No description available. ,
partiallyCompleted: No description available. ,
}
,
Required: True ,
}
enum ,
errors:
{
Description: The errors encountered while executing the job. ,
Required: False ,
}
[
{
code:
{
Description: One of a server-defined set of error codes. ,
Required: True ,
}
string ,
message:
{
Description: A human-readable representation of the error. ,
Required: True ,
}
string ,
target:
{
Description: The target of the error. ,
Required: False ,
}
string ,
details:
{
Description: An array of details about specific errors that led to this reported error. ,
Required: False ,
}
[
string ,
]
,
innererror:
{
Description: An object containing more specific information than the current object about the error. ,
Required: False ,
}
{
code:
{
Description: One of a server-defined set of error codes. ,
Required: False ,
}
string ,
innererror:
{
Required: False ,
}
string ,
}
,
}
,
]
,
resultUrl:
{
Description: URL to download the result of the Export Job. ,
Required: True ,
}
string ,
}

⚐ Response (default)

{
$headers:
{
x-ms-error-code:
{
Description: String error code indicating what went wrong. ,
}
string ,
}
,
$schema:
{
Description: Error response. ,
}
{
error:
{
Description: The error object. ,
Required: True ,
}
{
code:
{
Description: One of a server-defined set of error codes. ,
Enum:
{
InvalidRequest: Invalid request error ,
InvalidArgument: Invalid argument error ,
Unauthorized: Unauthorized access error ,
Forbidden: Forbidden access error ,
NotFound: Not found error ,
ProjectNotFound: Project not found error ,
OperationNotFound: Operation not found error ,
AzureCognitiveSearchNotFound: Azure Cognitive Search not found error ,
AzureCognitiveSearchIndexNotFound: Azure Cognitive Search index not found error ,
TooManyRequests: Too many requests error ,
AzureCognitiveSearchThrottling: Azure Cognitive Search throttling error ,
AzureCognitiveSearchIndexLimitReached: Azure Cognitive Search index limit reached error ,
InternalServerError: Internal server error ,
ServiceUnavailable: Service unavailable error ,
Timeout: Timeout error ,
QuotaExceeded: Quota exceeded error ,
Conflict: Conflict error ,
Warning: Warning error ,
}
,
Required: True ,
}
enum ,
message:
{
Description: A human-readable representation of the error. ,
Required: True ,
}
string ,
target:
{
Description: The target of the error. ,
Required: False ,
}
string ,
details:
{
Description: An array of details about specific errors that led to this reported error. ,
Required: False ,
}
[
string ,
]
,
innererror:
{
Description: An object containing more specific information than the current object about the error. ,
Required: False ,
}
{
code:
{
Description: One of a server-defined set of error codes. ,
Enum:
{
InvalidRequest: Invalid request error ,
InvalidParameterValue: Invalid parameter value error ,
KnowledgeBaseNotFound: Knowledge base not found error ,
AzureCognitiveSearchNotFound: Azure Cognitive Search not found error ,
AzureCognitiveSearchThrottling: Azure Cognitive Search throttling error ,
ExtractionFailure: Extraction failure error ,
InvalidRequestBodyFormat: Invalid request body format error ,
EmptyRequest: Empty request error ,
MissingInputDocuments: Missing input documents error ,
InvalidDocument: Invalid document error ,
ModelVersionIncorrect: Model version incorrect error ,
InvalidDocumentBatch: Invalid document batch error ,
UnsupportedLanguageCode: Unsupported language code error ,
InvalidCountryHint: Invalid country hint error ,
}
,
Required: True ,
}
enum ,
message:
{
Description: Error message. ,
Required: True ,
}
string ,
details:
{
Description: Error details. ,
Required: False ,
}
object ,
target:
{
Description: Error target. ,
Required: False ,
}
string ,
innererror:
{
Required: False ,
}
string ,
}
,
}
,
}
,
}
QuestionAnsweringProjects_AddFeedback (updated)
Description :  Update Active Learning feedback.
Reference :  Link ¶

⚶ Changes

{
  "#id": "QuestionAnsweringProjects_AddFeedback",
  "$parameters": [
    {
      "#name": "api-version",
      "Description": {
        "new": "The API version to use for this operation.",
        "old": "Client API version."
      }
    }
  ],
  "$responses": {
    "default": {
      "$properties": {
        "error": [
          {
            "#name": "code",
            "Enum": {
              "new": [
                [
                  "InvalidRequest",
                  "Invalid request error"
                ],
                [
                  "InvalidArgument",
                  "Invalid argument error"
                ],
                [
                  "Unauthorized",
                  "Unauthorized access error"
                ],
                [
                  "Forbidden",
                  "Forbidden access error"
                ],
                [
                  "NotFound",
                  "Not found error"
                ],
                [
                  "ProjectNotFound",
                  "Project not found error"
                ],
                [
                  "OperationNotFound",
                  "Operation not found error"
                ],
                [
                  "AzureCognitiveSearchNotFound",
                  "Azure Cognitive Search not found error"
                ],
                [
                  "AzureCognitiveSearchIndexNotFound",
                  "Azure Cognitive Search index not found error"
                ],
                [
                  "TooManyRequests",
                  "Too many requests error"
                ],
                [
                  "AzureCognitiveSearchThrottling",
                  "Azure Cognitive Search throttling error"
                ],
                [
                  "AzureCognitiveSearchIndexLimitReached",
                  "Azure Cognitive Search index limit reached error"
                ],
                [
                  "InternalServerError",
                  "Internal server error"
                ],
                [
                  "ServiceUnavailable",
                  "Service unavailable error"
                ],
                [
                  "Timeout",
                  "Timeout error"
                ],
                [
                  "QuotaExceeded",
                  "Quota exceeded error"
                ],
                [
                  "Conflict",
                  "Conflict error"
                ],
                [
                  "Warning",
                  "Warning error"
                ]
              ],
              "old": [
                [
                  "InvalidRequest",
                  ""
                ],
                [
                  "InvalidArgument",
                  ""
                ],
                [
                  "Unauthorized",
                  ""
                ],
                [
                  "Forbidden",
                  ""
                ],
                [
                  "NotFound",
                  ""
                ],
                [
                  "ProjectNotFound",
                  ""
                ],
                [
                  "OperationNotFound",
                  ""
                ],
                [
                  "AzureCognitiveSearchNotFound",
                  ""
                ],
                [
                  "AzureCognitiveSearchIndexNotFound",
                  ""
                ],
                [
                  "TooManyRequests",
                  ""
                ],
                [
                  "AzureCognitiveSearchThrottling",
                  ""
                ],
                [
                  "AzureCognitiveSearchIndexLimitReached",
                  ""
                ],
                [
                  "InternalServerError",
                  ""
                ],
                [
                  "ServiceUnavailable",
                  ""
                ],
                [
                  "Timeout",
                  ""
                ],
                [
                  "QuotaExceeded",
                  ""
                ],
                [
                  "Conflict",
                  ""
                ],
                [
                  "Warning",
                  ""
                ]
              ]
            }
          },
          {
            "#name": "innererror",
            "Description": {
              "new": "An object containing more specific information than the current object about\nthe error.",
              "old": "An object containing more specific information than the current object about the error."
            },
            "$properties": [
              {
                "#name": "code",
                "Enum": {
                  "new": [
                    [
                      "InvalidRequest",
                      "Invalid request error"
                    ],
                    [
                      "InvalidParameterValue",
                      "Invalid parameter value error"
                    ],
                    [
                      "KnowledgeBaseNotFound",
                      "Knowledge base not found error"
                    ],
                    [
                      "AzureCognitiveSearchNotFound",
                      "Azure Cognitive Search not found error"
                    ],
                    [
                      "AzureCognitiveSearchThrottling",
                      "Azure Cognitive Search throttling error"
                    ],
                    [
                      "ExtractionFailure",
                      "Extraction failure error"
                    ],
                    [
                      "InvalidRequestBodyFormat",
                      "Invalid request body format error"
                    ],
                    [
                      "EmptyRequest",
                      "Empty request error"
                    ],
                    [
                      "MissingInputDocuments",
                      "Missing input documents error"
                    ],
                    [
                      "InvalidDocument",
                      "Invalid document error"
                    ],
                    [
                      "ModelVersionIncorrect",
                      "Model version incorrect error"
                    ],
                    [
                      "InvalidDocumentBatch",
                      "Invalid document batch error"
                    ],
                    [
                      "UnsupportedLanguageCode",
                      "Unsupported language code error"
                    ],
                    [
                      "InvalidCountryHint",
                      "Invalid country hint error"
                    ]
                  ],
                  "old": [
                    [
                      "InvalidRequest",
                      ""
                    ],
                    [
                      "InvalidParameterValue",
                      ""
                    ],
                    [
                      "KnowledgeBaseNotFound",
                      ""
                    ],
                    [
                      "AzureCognitiveSearchNotFound",
                      ""
                    ],
                    [
                      "AzureCognitiveSearchThrottling",
                      ""
                    ],
                    [
                      "ExtractionFailure",
                      ""
                    ],
                    [
                      "InvalidRequestBodyFormat",
                      ""
                    ],
                    [
                      "EmptyRequest",
                      ""
                    ],
                    [
                      "MissingInputDocuments",
                      ""
                    ],
                    [
                      "InvalidDocument",
                      ""
                    ],
                    [
                      "ModelVersionIncorrect",
                      ""
                    ],
                    [
                      "InvalidDocumentBatch",
                      ""
                    ],
                    [
                      "UnsupportedLanguageCode",
                      ""
                    ],
                    [
                      "InvalidCountryHint",
                      ""
                    ]
                  ]
                }
              }
            ]
          }
        ]
      }
    }
  }
}

⚼ Request

POST:  /authoring/query-knowledgebases/projects/{projectName}/feedback
{
api-version:
{
Description: The API version to use for this operation. ,
Required: True ,
}
string ,
projectName:
{
Description: The name of the project to use. ,
Required: True ,
}
string ,
body:
{
Description: Feedback for Active Learning. ,
Required: True ,
}
{
records:
{
Description: A list of Feedback Records for Active Learning. ,
Required: False ,
}
[
{
userId:
{
Description: Unique identifier of the user. ,
Required: False ,
}
string ,
userQuestion:
{
Description: User suggested question for the QnA. ,
Required: False ,
}
string ,
qnaId:
{
Description: Unique ID of the QnA. ,
Format: int32 ,
Required: False ,
}
integer ,
}
,
]
,
}
,
}

⚐ Response (204)

{}

⚐ Response (default)

{
$headers:
{
x-ms-error-code:
{
Description: String error code indicating what went wrong. ,
}
string ,
}
,
$schema:
{
Description: Error response. ,
}
{
error:
{
Description: The error object. ,
Required: True ,
}
{
code:
{
Description: One of a server-defined set of error codes. ,
Enum:
{
InvalidRequest: Invalid request error ,
InvalidArgument: Invalid argument error ,
Unauthorized: Unauthorized access error ,
Forbidden: Forbidden access error ,
NotFound: Not found error ,
ProjectNotFound: Project not found error ,
OperationNotFound: Operation not found error ,
AzureCognitiveSearchNotFound: Azure Cognitive Search not found error ,
AzureCognitiveSearchIndexNotFound: Azure Cognitive Search index not found error ,
TooManyRequests: Too many requests error ,
AzureCognitiveSearchThrottling: Azure Cognitive Search throttling error ,
AzureCognitiveSearchIndexLimitReached: Azure Cognitive Search index limit reached error ,
InternalServerError: Internal server error ,
ServiceUnavailable: Service unavailable error ,
Timeout: Timeout error ,
QuotaExceeded: Quota exceeded error ,
Conflict: Conflict error ,
Warning: Warning error ,
}
,
Required: True ,
}
enum ,
message:
{
Description: A human-readable representation of the error. ,
Required: True ,
}
string ,
target:
{
Description: The target of the error. ,
Required: False ,
}
string ,
details:
{
Description: An array of details about specific errors that led to this reported error. ,
Required: False ,
}
[
string ,
]
,
innererror:
{
Description: An object containing more specific information than the current object about the error. ,
Required: False ,
}
{
code:
{
Description: One of a server-defined set of error codes. ,
Enum:
{
InvalidRequest: Invalid request error ,
InvalidParameterValue: Invalid parameter value error ,
KnowledgeBaseNotFound: Knowledge base not found error ,
AzureCognitiveSearchNotFound: Azure Cognitive Search not found error ,
AzureCognitiveSearchThrottling: Azure Cognitive Search throttling error ,
ExtractionFailure: Extraction failure error ,
InvalidRequestBodyFormat: Invalid request body format error ,
EmptyRequest: Empty request error ,
MissingInputDocuments: Missing input documents error ,
InvalidDocument: Invalid document error ,
ModelVersionIncorrect: Model version incorrect error ,
InvalidDocumentBatch: Invalid document batch error ,
UnsupportedLanguageCode: Unsupported language code error ,
InvalidCountryHint: Invalid country hint error ,
}
,
Required: True ,
}
enum ,
message:
{
Description: Error message. ,
Required: True ,
}
string ,
details:
{
Description: Error details. ,
Required: False ,
}
object ,
target:
{
Description: Error target. ,
Required: False ,
}
string ,
innererror:
{
Required: False ,
}
string ,
}
,
}
,
}
,
}
QuestionAnsweringProjects_GetImportStatus (updated)
Description :  Gets the status of an Import job.
Reference :  Link ¶

⚶ Changes

{
  "#id": "QuestionAnsweringProjects_GetImportStatus",
  "$parameters": [
    {
      "#name": "api-version",
      "Description": {
        "new": "The API version to use for this operation.",
        "old": "Client API version."
      }
    },
    {
      "#name": "projectName",
      "Description": {
        "new": "Name of the project.",
        "old": "The name of the project to use."
      }
    },
    {
      "#name": "jobId",
      "Description": {
        "new": "The job ID.",
        "old": "Job ID."
      }
    }
  ],
  "$responses": {
    "200": {
      "Description": {
        "new": "Import job status, project metadata, and assets.",
        "old": "Job state represents the job metadata and any errors."
      },
      "Type": {
        "new": "object",
        "old": "string"
      }
    },
    "default": {
      "$properties": {
        "error": [
          {
            "#name": "code",
            "Enum": {
              "new": [
                [
                  "InvalidRequest",
                  "Invalid request error"
                ],
                [
                  "InvalidArgument",
                  "Invalid argument error"
                ],
                [
                  "Unauthorized",
                  "Unauthorized access error"
                ],
                [
                  "Forbidden",
                  "Forbidden access error"
                ],
                [
                  "NotFound",
                  "Not found error"
                ],
                [
                  "ProjectNotFound",
                  "Project not found error"
                ],
                [
                  "OperationNotFound",
                  "Operation not found error"
                ],
                [
                  "AzureCognitiveSearchNotFound",
                  "Azure Cognitive Search not found error"
                ],
                [
                  "AzureCognitiveSearchIndexNotFound",
                  "Azure Cognitive Search index not found error"
                ],
                [
                  "TooManyRequests",
                  "Too many requests error"
                ],
                [
                  "AzureCognitiveSearchThrottling",
                  "Azure Cognitive Search throttling error"
                ],
                [
                  "AzureCognitiveSearchIndexLimitReached",
                  "Azure Cognitive Search index limit reached error"
                ],
                [
                  "InternalServerError",
                  "Internal server error"
                ],
                [
                  "ServiceUnavailable",
                  "Service unavailable error"
                ],
                [
                  "Timeout",
                  "Timeout error"
                ],
                [
                  "QuotaExceeded",
                  "Quota exceeded error"
                ],
                [
                  "Conflict",
                  "Conflict error"
                ],
                [
                  "Warning",
                  "Warning error"
                ]
              ],
              "old": [
                [
                  "InvalidRequest",
                  ""
                ],
                [
                  "InvalidArgument",
                  ""
                ],
                [
                  "Unauthorized",
                  ""
                ],
                [
                  "Forbidden",
                  ""
                ],
                [
                  "NotFound",
                  ""
                ],
                [
                  "ProjectNotFound",
                  ""
                ],
                [
                  "OperationNotFound",
                  ""
                ],
                [
                  "AzureCognitiveSearchNotFound",
                  ""
                ],
                [
                  "AzureCognitiveSearchIndexNotFound",
                  ""
                ],
                [
                  "TooManyRequests",
                  ""
                ],
                [
                  "AzureCognitiveSearchThrottling",
                  ""
                ],
                [
                  "AzureCognitiveSearchIndexLimitReached",
                  ""
                ],
                [
                  "InternalServerError",
                  ""
                ],
                [
                  "ServiceUnavailable",
                  ""
                ],
                [
                  "Timeout",
                  ""
                ],
                [
                  "QuotaExceeded",
                  ""
                ],
                [
                  "Conflict",
                  ""
                ],
                [
                  "Warning",
                  ""
                ]
              ]
            }
          },
          {
            "#name": "innererror",
            "Description": {
              "new": "An object containing more specific information than the current object about\nthe error.",
              "old": "An object containing more specific information than the current object about the error."
            },
            "$properties": [
              {
                "#name": "code",
                "Enum": {
                  "new": [
                    [
                      "InvalidRequest",
                      "Invalid request error"
                    ],
                    [
                      "InvalidParameterValue",
                      "Invalid parameter value error"
                    ],
                    [
                      "KnowledgeBaseNotFound",
                      "Knowledge base not found error"
                    ],
                    [
                      "AzureCognitiveSearchNotFound",
                      "Azure Cognitive Search not found error"
                    ],
                    [
                      "AzureCognitiveSearchThrottling",
                      "Azure Cognitive Search throttling error"
                    ],
                    [
                      "ExtractionFailure",
                      "Extraction failure error"
                    ],
                    [
                      "InvalidRequestBodyFormat",
                      "Invalid request body format error"
                    ],
                    [
                      "EmptyRequest",
                      "Empty request error"
                    ],
                    [
                      "MissingInputDocuments",
                      "Missing input documents error"
                    ],
                    [
                      "InvalidDocument",
                      "Invalid document error"
                    ],
                    [
                      "ModelVersionIncorrect",
                      "Model version incorrect error"
                    ],
                    [
                      "InvalidDocumentBatch",
                      "Invalid document batch error"
                    ],
                    [
                      "UnsupportedLanguageCode",
                      "Unsupported language code error"
                    ],
                    [
                      "InvalidCountryHint",
                      "Invalid country hint error"
                    ]
                  ],
                  "old": [
                    [
                      "InvalidRequest",
                      ""
                    ],
                    [
                      "InvalidParameterValue",
                      ""
                    ],
                    [
                      "KnowledgeBaseNotFound",
                      ""
                    ],
                    [
                      "AzureCognitiveSearchNotFound",
                      ""
                    ],
                    [
                      "AzureCognitiveSearchThrottling",
                      ""
                    ],
                    [
                      "ExtractionFailure",
                      ""
                    ],
                    [
                      "InvalidRequestBodyFormat",
                      ""
                    ],
                    [
                      "EmptyRequest",
                      ""
                    ],
                    [
                      "MissingInputDocuments",
                      ""
                    ],
                    [
                      "InvalidDocument",
                      ""
                    ],
                    [
                      "ModelVersionIncorrect",
                      ""
                    ],
                    [
                      "InvalidDocumentBatch",
                      ""
                    ],
                    [
                      "UnsupportedLanguageCode",
                      ""
                    ],
                    [
                      "InvalidCountryHint",
                      ""
                    ]
                  ]
                }
              }
            ]
          }
        ]
      }
    }
  }
}

⚼ Request

GET:  /authoring/query-knowledgebases/projects/{projectName}/import/jobs/{jobId}
{
api-version:
{
Description: The API version to use for this operation. ,
Required: True ,
}
string ,
projectName:
{
Description: Name of the project. ,
Required: True ,
}
string ,
jobId:
{
Description: The job ID. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
createdDateTime:
{
Description: The creation date time of the job. ,
Format: date-time ,
Required: True ,
}
string ,
expirationDateTime:
{
Description: The expiration date time of the job. ,
Format: date-time ,
Required: False ,
}
string ,
jobId:
{
Description: The job ID. ,
Required: True ,
}
string ,
lastUpdatedDateTime:
{
Description: The last date time the job was updated. ,
Format: date-time ,
Required: True ,
}
string ,
status:
{
Description: Job Status. ,
Enum:
{
notStarted: No description available. ,
running: No description available. ,
succeeded: No description available. ,
failed: No description available. ,
cancelled: No description available. ,
cancelling: No description available. ,
partiallyCompleted: No description available. ,
}
,
Required: True ,
}
enum ,
errors:
{
Description: The errors encountered while executing the job. ,
Required: False ,
}
[
{
code:
{
Description: One of a server-defined set of error codes. ,
Required: True ,
}
string ,
message:
{
Description: A human-readable representation of the error. ,
Required: True ,
}
string ,
target:
{
Description: The target of the error. ,
Required: False ,
}
string ,
details:
{
Description: An array of details about specific errors that led to this reported error. ,
Required: False ,
}
[
string ,
]
,
innererror:
{
Description: An object containing more specific information than the current object about the error. ,
Required: False ,
}
{
code:
{
Description: One of a server-defined set of error codes. ,
Required: False ,
}
string ,
innererror:
{
Required: False ,
}
string ,
}
,
}
,
]
,
}

⚐ Response (default)

{
$headers:
{
x-ms-error-code:
{
Description: String error code indicating what went wrong. ,
}
string ,
}
,
$schema:
{
Description: Error response. ,
}
{
error:
{
Description: The error object. ,
Required: True ,
}
{
code:
{
Description: One of a server-defined set of error codes. ,
Enum:
{
InvalidRequest: Invalid request error ,
InvalidArgument: Invalid argument error ,
Unauthorized: Unauthorized access error ,
Forbidden: Forbidden access error ,
NotFound: Not found error ,
ProjectNotFound: Project not found error ,
OperationNotFound: Operation not found error ,
AzureCognitiveSearchNotFound: Azure Cognitive Search not found error ,
AzureCognitiveSearchIndexNotFound: Azure Cognitive Search index not found error ,
TooManyRequests: Too many requests error ,
AzureCognitiveSearchThrottling: Azure Cognitive Search throttling error ,
AzureCognitiveSearchIndexLimitReached: Azure Cognitive Search index limit reached error ,
InternalServerError: Internal server error ,
ServiceUnavailable: Service unavailable error ,
Timeout: Timeout error ,
QuotaExceeded: Quota exceeded error ,
Conflict: Conflict error ,
Warning: Warning error ,
}
,
Required: True ,
}
enum ,
message:
{
Description: A human-readable representation of the error. ,
Required: True ,
}
string ,
target:
{
Description: The target of the error. ,
Required: False ,
}
string ,
details:
{
Description: An array of details about specific errors that led to this reported error. ,
Required: False ,
}
[
string ,
]
,
innererror:
{
Description: An object containing more specific information than the current object about the error. ,
Required: False ,
}
{
code:
{
Description: One of a server-defined set of error codes. ,
Enum:
{
InvalidRequest: Invalid request error ,
InvalidParameterValue: Invalid parameter value error ,
KnowledgeBaseNotFound: Knowledge base not found error ,
AzureCognitiveSearchNotFound: Azure Cognitive Search not found error ,
AzureCognitiveSearchThrottling: Azure Cognitive Search throttling error ,
ExtractionFailure: Extraction failure error ,
InvalidRequestBodyFormat: Invalid request body format error ,
EmptyRequest: Empty request error ,
MissingInputDocuments: Missing input documents error ,
InvalidDocument: Invalid document error ,
ModelVersionIncorrect: Model version incorrect error ,
InvalidDocumentBatch: Invalid document batch error ,
UnsupportedLanguageCode: Unsupported language code error ,
InvalidCountryHint: Invalid country hint error ,
}
,
Required: True ,
}
enum ,
message:
{
Description: Error message. ,
Required: True ,
}
string ,
details:
{
Description: Error details. ,
Required: False ,
}
object ,
target:
{
Description: Error target. ,
Required: False ,
}
string ,
innererror:
{
Required: False ,
}
string ,
}
,
}
,
}
,
}
QuestionAnsweringProjects_GetQnas (updated)
Description :  Gets all the QnAs of a project.
Reference :  Link ¶

⚶ Changes

{
  "#id": "QuestionAnsweringProjects_GetQnas",
  "$parameters": [
    {
      "#name": "api-version",
      "Description": {
        "new": "The API version to use for this operation.",
        "old": "Client API version."
      }
    },
    {
      "#name": "projectName",
      "Description": {
        "new": "Name of the project.",
        "old": "The name of the project to use."
      }
    }
  ],
  "$responses": {
    "200": {
      "Description": {
        "new": "Paged collection of RetrieveQnaRecord items",
        "old": "All QnA assets for the project."
      },
      "$properties": [
        {
          "#name": "value",
          "Description": {
            "new": "The RetrieveQnaRecord items on this page",
            "old": "List of QnA records."
          },
          "Required": {
            "new": true,
            "old": false
          },
          "$items": {
            "Type": {
              "new": "object",
              "old": "string"
            }
          }
        }
      ]
    },
    "default": {
      "$properties": {
        "error": [
          {
            "#name": "code",
            "Enum": {
              "new": [
                [
                  "InvalidRequest",
                  "Invalid request error"
                ],
                [
                  "InvalidArgument",
                  "Invalid argument error"
                ],
                [
                  "Unauthorized",
                  "Unauthorized access error"
                ],
                [
                  "Forbidden",
                  "Forbidden access error"
                ],
                [
                  "NotFound",
                  "Not found error"
                ],
                [
                  "ProjectNotFound",
                  "Project not found error"
                ],
                [
                  "OperationNotFound",
                  "Operation not found error"
                ],
                [
                  "AzureCognitiveSearchNotFound",
                  "Azure Cognitive Search not found error"
                ],
                [
                  "AzureCognitiveSearchIndexNotFound",
                  "Azure Cognitive Search index not found error"
                ],
                [
                  "TooManyRequests",
                  "Too many requests error"
                ],
                [
                  "AzureCognitiveSearchThrottling",
                  "Azure Cognitive Search throttling error"
                ],
                [
                  "AzureCognitiveSearchIndexLimitReached",
                  "Azure Cognitive Search index limit reached error"
                ],
                [
                  "InternalServerError",
                  "Internal server error"
                ],
                [
                  "ServiceUnavailable",
                  "Service unavailable error"
                ],
                [
                  "Timeout",
                  "Timeout error"
                ],
                [
                  "QuotaExceeded",
                  "Quota exceeded error"
                ],
                [
                  "Conflict",
                  "Conflict error"
                ],
                [
                  "Warning",
                  "Warning error"
                ]
              ],
              "old": [
                [
                  "InvalidRequest",
                  ""
                ],
                [
                  "InvalidArgument",
                  ""
                ],
                [
                  "Unauthorized",
                  ""
                ],
                [
                  "Forbidden",
                  ""
                ],
                [
                  "NotFound",
                  ""
                ],
                [
                  "ProjectNotFound",
                  ""
                ],
                [
                  "OperationNotFound",
                  ""
                ],
                [
                  "AzureCognitiveSearchNotFound",
                  ""
                ],
                [
                  "AzureCognitiveSearchIndexNotFound",
                  ""
                ],
                [
                  "TooManyRequests",
                  ""
                ],
                [
                  "AzureCognitiveSearchThrottling",
                  ""
                ],
                [
                  "AzureCognitiveSearchIndexLimitReached",
                  ""
                ],
                [
                  "InternalServerError",
                  ""
                ],
                [
                  "ServiceUnavailable",
                  ""
                ],
                [
                  "Timeout",
                  ""
                ],
                [
                  "QuotaExceeded",
                  ""
                ],
                [
                  "Conflict",
                  ""
                ],
                [
                  "Warning",
                  ""
                ]
              ]
            }
          },
          {
            "#name": "innererror",
            "Description": {
              "new": "An object containing more specific information than the current object about\nthe error.",
              "old": "An object containing more specific information than the current object about the error."
            },
            "$properties": [
              {
                "#name": "code",
                "Enum": {
                  "new": [
                    [
                      "InvalidRequest",
                      "Invalid request error"
                    ],
                    [
                      "InvalidParameterValue",
                      "Invalid parameter value error"
                    ],
                    [
                      "KnowledgeBaseNotFound",
                      "Knowledge base not found error"
                    ],
                    [
                      "AzureCognitiveSearchNotFound",
                      "Azure Cognitive Search not found error"
                    ],
                    [
                      "AzureCognitiveSearchThrottling",
                      "Azure Cognitive Search throttling error"
                    ],
                    [
                      "ExtractionFailure",
                      "Extraction failure error"
                    ],
                    [
                      "InvalidRequestBodyFormat",
                      "Invalid request body format error"
                    ],
                    [
                      "EmptyRequest",
                      "Empty request error"
                    ],
                    [
                      "MissingInputDocuments",
                      "Missing input documents error"
                    ],
                    [
                      "InvalidDocument",
                      "Invalid document error"
                    ],
                    [
                      "ModelVersionIncorrect",
                      "Model version incorrect error"
                    ],
                    [
                      "InvalidDocumentBatch",
                      "Invalid document batch error"
                    ],
                    [
                      "UnsupportedLanguageCode",
                      "Unsupported language code error"
                    ],
                    [
                      "InvalidCountryHint",
                      "Invalid country hint error"
                    ]
                  ],
                  "old": [
                    [
                      "InvalidRequest",
                      ""
                    ],
                    [
                      "InvalidParameterValue",
                      ""
                    ],
                    [
                      "KnowledgeBaseNotFound",
                      ""
                    ],
                    [
                      "AzureCognitiveSearchNotFound",
                      ""
                    ],
                    [
                      "AzureCognitiveSearchThrottling",
                      ""
                    ],
                    [
                      "ExtractionFailure",
                      ""
                    ],
                    [
                      "InvalidRequestBodyFormat",
                      ""
                    ],
                    [
                      "EmptyRequest",
                      ""
                    ],
                    [
                      "MissingInputDocuments",
                      ""
                    ],
                    [
                      "InvalidDocument",
                      ""
                    ],
                    [
                      "ModelVersionIncorrect",
                      ""
                    ],
                    [
                      "InvalidDocumentBatch",
                      ""
                    ],
                    [
                      "UnsupportedLanguageCode",
                      ""
                    ],
                    [
                      "InvalidCountryHint",
                      ""
                    ]
                  ]
                }
              }
            ]
          }
        ]
      }
    }
  }
}

⚼ Request

GET:  /authoring/query-knowledgebases/projects/{projectName}/qnas
{
api-version:
{
Description: The API version to use for this operation. ,
Required: True ,
}
string ,
projectName:
{
Description: Name of the project. ,
Required: True ,
}
string ,
top:
{
Description: The maximum number of resources to return from the collection. ,
Format: int32 ,
Required: False ,
}
integer ,
skip:
{
Description: An offset into the collection of the first resource to be returned. ,
Format: int32 ,
Required: False ,
}
integer ,
maxpagesize:
{
Description: The maximum number of resources to include in a single response. ,
Format: int32 ,
Required: False ,
}
integer ,
source:
{
Description: Source of the QnA. ,
Required: False ,
}
string ,
}

⚐ Response (200)

{
value:
{
Description: The RetrieveQnaRecord items on this page ,
Required: True ,
}
[
{
id:
{
Description: Unique ID for the QnA. ,
Format: int32 ,
Required: True ,
}
integer ,
answer:
{
Description: Answer text. ,
Required: False ,
}
string ,
source:
{
Description: Source from which QnA was indexed e.g. https://docs.microsoft.com/en-us/azure/cognitive-services/QnAMaker/FAQs . ,
Required: False ,
}
string ,
questions:
{
Description: List of questions associated with the answer. ,
Required: False ,
}
[
string ,
]
,
metadata:
{
Description: Metadata associated with the answer, useful to categorize or filter question answers. ,
Required: False ,
}
object ,
dialog:
{
Description: Context of a QnA. ,
Required: False ,
}
{
isContextOnly:
{
Description: To mark if a prompt is relevant only with a previous question or not. If true, do not include this QnA as answer for queries without context; otherwise, ignores context and includes this QnA in answers. ,
Required: False ,
}
boolean ,
prompts:
{
Description: List of prompts associated with the answer. ,
Required: False ,
}
[
{
displayOrder:
{
Description: Index of the prompt. It is used for ordering of the prompts. ,
Format: int32 ,
Required: False ,
}
integer ,
qnaId:
{
Description: ID of the QnA corresponding to the prompt. ,
Format: int32 ,
Required: False ,
}
integer ,
qna:
{
Description: QnA record. Either QnAId or QnA record needs to be present in a Prompt. ,
Required: False ,
}
{
id:
{
Description: Unique ID for the QnA. ,
Format: int32 ,
Required: True ,
}
integer ,
answer:
{
Description: Answer text. ,
Required: False ,
}
string ,
source:
{
Description: Source from which QnA was indexed e.g. https://docs.microsoft.com/en-us/azure/cognitive-services/QnAMaker/FAQs . ,
Required: False ,
}
string ,
questions:
{
Description: List of questions associated with the answer. ,
Required: False ,
}
[
string ,
]
,
metadata:
{
Description: Metadata associated with the answer, useful to categorize or filter question answers. ,
Required: False ,
}
object ,
dialog:
{
Required: False ,
}
string ,
activeLearningSuggestions:
{
Description: List of Active Learning suggestions for the QnA. ,
Required: False ,
}
[
{
clusterHead:
{
Description: Question chosen as the head of suggested questions cluster by Active Learning clustering algorithm. ,
Required: False ,
}
string ,
suggestedQuestions:
{
Description: List of all suggested questions for the QnA. ,
Required: False ,
}
[
{
question:
{
Description: Question suggested by the Active Learning feature. ,
Required: False ,
}
string ,
userSuggestedCount:
{
Description: The number of times the question was suggested explicitly by the user. ,
Format: int32 ,
Required: False ,
}
integer ,
autoSuggestedCount:
{
Description: The number of times the question was suggested automatically by the Active Learning algorithm. ,
Format: int32 ,
Required: False ,
}
integer ,
}
,
]
,
}
,
]
,
}
,
displayText:
{
Description: Text displayed to represent a follow up question prompt. ,
Required: False ,
}
string ,
}
,
]
,
}
,
activeLearningSuggestions:
{
Description: List of Active Learning suggestions for the QnA. ,
Required: False ,
}
[
{
clusterHead:
{
Description: Question chosen as the head of suggested questions cluster by Active Learning clustering algorithm. ,
Required: False ,
}
string ,
suggestedQuestions:
{
Description: List of all suggested questions for the QnA. ,
Required: False ,
}
[
{
question:
{
Description: Question suggested by the Active Learning feature. ,
Required: False ,
}
string ,
userSuggestedCount:
{
Description: The number of times the question was suggested explicitly by the user. ,
Format: int32 ,
Required: False ,
}
integer ,
autoSuggestedCount:
{
Description: The number of times the question was suggested automatically by the Active Learning algorithm. ,
Format: int32 ,
Required: False ,
}
integer ,
}
,
]
,
}
,
]
,
lastUpdatedDateTime:
{
Description: Date-time when the QnA was last updated. ,
Format: date-time ,
Required: False ,
}
string ,
}
,
]
,
nextLink:
{
Description: The link to the next page of items ,
Format: uri ,
Required: False ,
}
string ,
}

⚐ Response (default)

{
$headers:
{
x-ms-error-code:
{
Description: String error code indicating what went wrong. ,
}
string ,
}
,
$schema:
{
Description: Error response. ,
}
{
error:
{
Description: The error object. ,
Required: True ,
}
{
code:
{
Description: One of a server-defined set of error codes. ,
Enum:
{
InvalidRequest: Invalid request error ,
InvalidArgument: Invalid argument error ,
Unauthorized: Unauthorized access error ,
Forbidden: Forbidden access error ,
NotFound: Not found error ,
ProjectNotFound: Project not found error ,
OperationNotFound: Operation not found error ,
AzureCognitiveSearchNotFound: Azure Cognitive Search not found error ,
AzureCognitiveSearchIndexNotFound: Azure Cognitive Search index not found error ,
TooManyRequests: Too many requests error ,
AzureCognitiveSearchThrottling: Azure Cognitive Search throttling error ,
AzureCognitiveSearchIndexLimitReached: Azure Cognitive Search index limit reached error ,
InternalServerError: Internal server error ,
ServiceUnavailable: Service unavailable error ,
Timeout: Timeout error ,
QuotaExceeded: Quota exceeded error ,
Conflict: Conflict error ,
Warning: Warning error ,
}
,
Required: True ,
}
enum ,
message:
{
Description: A human-readable representation of the error. ,
Required: True ,
}
string ,
target:
{
Description: The target of the error. ,
Required: False ,
}
string ,
details:
{
Description: An array of details about specific errors that led to this reported error. ,
Required: False ,
}
[
string ,
]
,
innererror:
{
Description: An object containing more specific information than the current object about the error. ,
Required: False ,
}
{
code:
{
Description: One of a server-defined set of error codes. ,
Enum:
{
InvalidRequest: Invalid request error ,
InvalidParameterValue: Invalid parameter value error ,
KnowledgeBaseNotFound: Knowledge base not found error ,
AzureCognitiveSearchNotFound: Azure Cognitive Search not found error ,
AzureCognitiveSearchThrottling: Azure Cognitive Search throttling error ,
ExtractionFailure: Extraction failure error ,
InvalidRequestBodyFormat: Invalid request body format error ,
EmptyRequest: Empty request error ,
MissingInputDocuments: Missing input documents error ,
InvalidDocument: Invalid document error ,
ModelVersionIncorrect: Model version incorrect error ,
InvalidDocumentBatch: Invalid document batch error ,
UnsupportedLanguageCode: Unsupported language code error ,
InvalidCountryHint: Invalid country hint error ,
}
,
Required: True ,
}
enum ,
message:
{
Description: Error message. ,
Required: True ,
}
string ,
details:
{
Description: Error details. ,
Required: False ,
}
object ,
target:
{
Description: Error target. ,
Required: False ,
}
string ,
innererror:
{
Required: False ,
}
string ,
}
,
}
,
}
,
}
QuestionAnsweringProjects_UpdateQnas (updated)
Description :  Updates the QnAs of a project.
Reference :  Link ¶

⚶ Changes

{
  "#id": "QuestionAnsweringProjects_UpdateQnas",
  "$parameters": [
    {
      "#name": "api-version",
      "Description": {
        "new": "The API version to use for this operation.",
        "old": "Client API version."
      }
    },
    {
      "body": {
        "$items": {
          "$properties": [
            {
              "#name": "op",
              "Enum": {
                "new": [
                  [
                    "add",
                    "Add operation."
                  ],
                  [
                    "delete",
                    "Delete operation."
                  ],
                  [
                    "replace",
                    "Replace operation."
                  ]
                ],
                "old": [
                  [
                    "add",
                    ""
                  ],
                  [
                    "delete",
                    ""
                  ],
                  [
                    "replace",
                    ""
                  ]
                ]
              }
            },
            {
              "value": [
                {
                  "#name": "id",
                  "Required": {
                    "new": true,
                    "old": false
                  }
                },
                {
                  "#name": "source",
                  "Description": {
                    "new": "Source from which QnA was indexed e.g.\nhttps://docs.microsoft.com/en-us/azure/cognitive-services/QnAMaker/FAQs .",
                    "old": "Source from which QnA was indexed e.g. https://docs.microsoft.com/en-us/azure/cognitive-services/QnAMaker/FAQs ."
                  }
                },
                {
                  "#name": "metadata",
                  "Description": {
                    "new": "Metadata associated with the answer, useful to categorize or filter question\nanswers.",
                    "old": "Metadata associated with the answer, useful to categorize or filter question answers."
                  }
                },
                {
                  "#name": "dialog",
                  "Type": {
                    "new": "string",
                    "old": "object"
                  }
                },
                {
                  "activeLearningSuggestions": {
                    "$properties": [
                      {
                        "#name": "clusterHead",
                        "Description": {
                          "new": "Question chosen as the head of suggested questions cluster by Active Learning\nclustering algorithm.",
                          "old": "Question chosen as the head of suggested questions cluster by Active Learning clustering algorithm."
                        }
                      },
                      {
                        "suggestedQuestions": {
                          "$properties": [
                            {
                              "#name": "autoSuggestedCount",
                              "Description": {
                                "new": "The number of times the question was suggested automatically by the Active\nLearning algorithm.",
                                "old": "The number of times the question was suggested automatically by the Active Learning algorithm."
                              }
                            }
                          ]
                        }
                      }
                    ]
                  }
                }
              ]
            }
          ]
        }
      }
    }
  ],
  "$responses": {
    "default": {
      "$properties": {
        "error": [
          {
            "#name": "code",
            "Enum": {
              "new": [
                [
                  "InvalidRequest",
                  "Invalid request error"
                ],
                [
                  "InvalidArgument",
                  "Invalid argument error"
                ],
                [
                  "Unauthorized",
                  "Unauthorized access error"
                ],
                [
                  "Forbidden",
                  "Forbidden access error"
                ],
                [
                  "NotFound",
                  "Not found error"
                ],
                [
                  "ProjectNotFound",
                  "Project not found error"
                ],
                [
                  "OperationNotFound",
                  "Operation not found error"
                ],
                [
                  "AzureCognitiveSearchNotFound",
                  "Azure Cognitive Search not found error"
                ],
                [
                  "AzureCognitiveSearchIndexNotFound",
                  "Azure Cognitive Search index not found error"
                ],
                [
                  "TooManyRequests",
                  "Too many requests error"
                ],
                [
                  "AzureCognitiveSearchThrottling",
                  "Azure Cognitive Search throttling error"
                ],
                [
                  "AzureCognitiveSearchIndexLimitReached",
                  "Azure Cognitive Search index limit reached error"
                ],
                [
                  "InternalServerError",
                  "Internal server error"
                ],
                [
                  "ServiceUnavailable",
                  "Service unavailable error"
                ],
                [
                  "Timeout",
                  "Timeout error"
                ],
                [
                  "QuotaExceeded",
                  "Quota exceeded error"
                ],
                [
                  "Conflict",
                  "Conflict error"
                ],
                [
                  "Warning",
                  "Warning error"
                ]
              ],
              "old": [
                [
                  "InvalidRequest",
                  ""
                ],
                [
                  "InvalidArgument",
                  ""
                ],
                [
                  "Unauthorized",
                  ""
                ],
                [
                  "Forbidden",
                  ""
                ],
                [
                  "NotFound",
                  ""
                ],
                [
                  "ProjectNotFound",
                  ""
                ],
                [
                  "OperationNotFound",
                  ""
                ],
                [
                  "AzureCognitiveSearchNotFound",
                  ""
                ],
                [
                  "AzureCognitiveSearchIndexNotFound",
                  ""
                ],
                [
                  "TooManyRequests",
                  ""
                ],
                [
                  "AzureCognitiveSearchThrottling",
                  ""
                ],
                [
                  "AzureCognitiveSearchIndexLimitReached",
                  ""
                ],
                [
                  "InternalServerError",
                  ""
                ],
                [
                  "ServiceUnavailable",
                  ""
                ],
                [
                  "Timeout",
                  ""
                ],
                [
                  "QuotaExceeded",
                  ""
                ],
                [
                  "Conflict",
                  ""
                ],
                [
                  "Warning",
                  ""
                ]
              ]
            }
          },
          {
            "#name": "innererror",
            "Description": {
              "new": "An object containing more specific information than the current object about\nthe error.",
              "old": "An object containing more specific information than the current object about the error."
            },
            "$properties": [
              {
                "#name": "code",
                "Enum": {
                  "new": [
                    [
                      "InvalidRequest",
                      "Invalid request error"
                    ],
                    [
                      "InvalidParameterValue",
                      "Invalid parameter value error"
                    ],
                    [
                      "KnowledgeBaseNotFound",
                      "Knowledge base not found error"
                    ],
                    [
                      "AzureCognitiveSearchNotFound",
                      "Azure Cognitive Search not found error"
                    ],
                    [
                      "AzureCognitiveSearchThrottling",
                      "Azure Cognitive Search throttling error"
                    ],
                    [
                      "ExtractionFailure",
                      "Extraction failure error"
                    ],
                    [
                      "InvalidRequestBodyFormat",
                      "Invalid request body format error"
                    ],
                    [
                      "EmptyRequest",
                      "Empty request error"
                    ],
                    [
                      "MissingInputDocuments",
                      "Missing input documents error"
                    ],
                    [
                      "InvalidDocument",
                      "Invalid document error"
                    ],
                    [
                      "ModelVersionIncorrect",
                      "Model version incorrect error"
                    ],
                    [
                      "InvalidDocumentBatch",
                      "Invalid document batch error"
                    ],
                    [
                      "UnsupportedLanguageCode",
                      "Unsupported language code error"
                    ],
                    [
                      "InvalidCountryHint",
                      "Invalid country hint error"
                    ]
                  ],
                  "old": [
                    [
                      "InvalidRequest",
                      ""
                    ],
                    [
                      "InvalidParameterValue",
                      ""
                    ],
                    [
                      "KnowledgeBaseNotFound",
                      ""
                    ],
                    [
                      "AzureCognitiveSearchNotFound",
                      ""
                    ],
                    [
                      "AzureCognitiveSearchThrottling",
                      ""
                    ],
                    [
                      "ExtractionFailure",
                      ""
                    ],
                    [
                      "InvalidRequestBodyFormat",
                      ""
                    ],
                    [
                      "EmptyRequest",
                      ""
                    ],
                    [
                      "MissingInputDocuments",
                      ""
                    ],
                    [
                      "InvalidDocument",
                      ""
                    ],
                    [
                      "ModelVersionIncorrect",
                      ""
                    ],
                    [
                      "InvalidDocumentBatch",
                      ""
                    ],
                    [
                      "UnsupportedLanguageCode",
                      ""
                    ],
                    [
                      "InvalidCountryHint",
                      ""
                    ]
                  ]
                }
              }
            ]
          }
        ]
      }
    }
  }
}

⚼ Request

PATCH:  /authoring/query-knowledgebases/projects/{projectName}/qnas
{
api-version:
{
Description: The API version to use for this operation. ,
Required: True ,
}
string ,
projectName:
{
Description: The name of the project to use. ,
Required: True ,
}
string ,
body:
{
Description: Update QnAs parameters of a project. ,
Required: True ,
}
{
op:
{
Description: Update operation type for assets. ,
Enum:
{
add: Add operation. ,
delete: Delete operation. ,
replace: Replace operation. ,
}
,
Required: True ,
}
enum ,
value:
{
Description: QnA record. ,
Required: True ,
}
{
id:
{
Description: Unique ID for the QnA. ,
Format: int32 ,
Required: True ,
}
integer ,
answer:
{
Description: Answer text. ,
Required: False ,
}
string ,
source:
{
Description: Source from which QnA was indexed e.g. https://docs.microsoft.com/en-us/azure/cognitive-services/QnAMaker/FAQs . ,
Required: False ,
}
string ,
questions:
{
Description: List of questions associated with the answer. ,
Required: False ,
}
[
string ,
]
,
metadata:
{
Description: Metadata associated with the answer, useful to categorize or filter question answers. ,
Required: False ,
}
object ,
dialog:
{
Required: False ,
}
string ,
activeLearningSuggestions:
{
Description: List of Active Learning suggestions for the QnA. ,
Required: False ,
}
[
{
clusterHead:
{
Description: Question chosen as the head of suggested questions cluster by Active Learning clustering algorithm. ,
Required: False ,
}
string ,
suggestedQuestions:
{
Description: List of all suggested questions for the QnA. ,
Required: False ,
}
[
{
question:
{
Description: Question suggested by the Active Learning feature. ,
Required: False ,
}
string ,
userSuggestedCount:
{
Description: The number of times the question was suggested explicitly by the user. ,
Format: int32 ,
Required: False ,
}
integer ,
autoSuggestedCount:
{
Description: The number of times the question was suggested automatically by the Active Learning algorithm. ,
Format: int32 ,
Required: False ,
}
integer ,
}
,
]
,
}
,
]
,
}
,
}
,
}

⚐ Response (202)

{
operation-location:
{
Description: The location for monitoring the operation state. ,
}
string ,
}

⚐ Response (default)

{
$headers:
{
x-ms-error-code:
{
Description: String error code indicating what went wrong. ,
}
string ,
}
,
$schema:
{
Description: Error response. ,
}
{
error:
{
Description: The error object. ,
Required: True ,
}
{
code:
{
Description: One of a server-defined set of error codes. ,
Enum:
{
InvalidRequest: Invalid request error ,
InvalidArgument: Invalid argument error ,
Unauthorized: Unauthorized access error ,
Forbidden: Forbidden access error ,
NotFound: Not found error ,
ProjectNotFound: Project not found error ,
OperationNotFound: Operation not found error ,
AzureCognitiveSearchNotFound: Azure Cognitive Search not found error ,
AzureCognitiveSearchIndexNotFound: Azure Cognitive Search index not found error ,
TooManyRequests: Too many requests error ,
AzureCognitiveSearchThrottling: Azure Cognitive Search throttling error ,
AzureCognitiveSearchIndexLimitReached: Azure Cognitive Search index limit reached error ,
InternalServerError: Internal server error ,
ServiceUnavailable: Service unavailable error ,
Timeout: Timeout error ,
QuotaExceeded: Quota exceeded error ,
Conflict: Conflict error ,
Warning: Warning error ,
}
,
Required: True ,
}
enum ,
message:
{
Description: A human-readable representation of the error. ,
Required: True ,
}
string ,
target:
{
Description: The target of the error. ,
Required: False ,
}
string ,
details:
{
Description: An array of details about specific errors that led to this reported error. ,
Required: False ,
}
[
string ,
]
,
innererror:
{
Description: An object containing more specific information than the current object about the error. ,
Required: False ,
}
{
code:
{
Description: One of a server-defined set of error codes. ,
Enum:
{
InvalidRequest: Invalid request error ,
InvalidParameterValue: Invalid parameter value error ,
KnowledgeBaseNotFound: Knowledge base not found error ,
AzureCognitiveSearchNotFound: Azure Cognitive Search not found error ,
AzureCognitiveSearchThrottling: Azure Cognitive Search throttling error ,
ExtractionFailure: Extraction failure error ,
InvalidRequestBodyFormat: Invalid request body format error ,
EmptyRequest: Empty request error ,
MissingInputDocuments: Missing input documents error ,
InvalidDocument: Invalid document error ,
ModelVersionIncorrect: Model version incorrect error ,
InvalidDocumentBatch: Invalid document batch error ,
UnsupportedLanguageCode: Unsupported language code error ,
InvalidCountryHint: Invalid country hint error ,
}
,
Required: True ,
}
enum ,
message:
{
Description: Error message. ,
Required: True ,
}
string ,
details:
{
Description: Error details. ,
Required: False ,
}
object ,
target:
{
Description: Error target. ,
Required: False ,
}
string ,
innererror:
{
Required: False ,
}
string ,
}
,
}
,
}
,
}
QuestionAnsweringProjects_GetUpdateQnasStatus (updated)
Description :  Gets the status of update QnAs job.
Reference :  Link ¶

⚶ Changes

{
  "#id": "QuestionAnsweringProjects_GetUpdateQnasStatus",
  "$parameters": [
    {
      "#name": "api-version",
      "Description": {
        "new": "The API version to use for this operation.",
        "old": "Client API version."
      }
    },
    {
      "#name": "projectName",
      "Description": {
        "new": "Name of the project.",
        "old": "The name of the project to use."
      }
    },
    {
      "#name": "jobId",
      "Description": {
        "new": "The job ID.",
        "old": "Job ID."
      }
    }
  ],
  "$responses": {
    "200": {
      "Type": {
        "new": "object",
        "old": "string"
      }
    },
    "default": {
      "$properties": {
        "error": [
          {
            "#name": "code",
            "Enum": {
              "new": [
                [
                  "InvalidRequest",
                  "Invalid request error"
                ],
                [
                  "InvalidArgument",
                  "Invalid argument error"
                ],
                [
                  "Unauthorized",
                  "Unauthorized access error"
                ],
                [
                  "Forbidden",
                  "Forbidden access error"
                ],
                [
                  "NotFound",
                  "Not found error"
                ],
                [
                  "ProjectNotFound",
                  "Project not found error"
                ],
                [
                  "OperationNotFound",
                  "Operation not found error"
                ],
                [
                  "AzureCognitiveSearchNotFound",
                  "Azure Cognitive Search not found error"
                ],
                [
                  "AzureCognitiveSearchIndexNotFound",
                  "Azure Cognitive Search index not found error"
                ],
                [
                  "TooManyRequests",
                  "Too many requests error"
                ],
                [
                  "AzureCognitiveSearchThrottling",
                  "Azure Cognitive Search throttling error"
                ],
                [
                  "AzureCognitiveSearchIndexLimitReached",
                  "Azure Cognitive Search index limit reached error"
                ],
                [
                  "InternalServerError",
                  "Internal server error"
                ],
                [
                  "ServiceUnavailable",
                  "Service unavailable error"
                ],
                [
                  "Timeout",
                  "Timeout error"
                ],
                [
                  "QuotaExceeded",
                  "Quota exceeded error"
                ],
                [
                  "Conflict",
                  "Conflict error"
                ],
                [
                  "Warning",
                  "Warning error"
                ]
              ],
              "old": [
                [
                  "InvalidRequest",
                  ""
                ],
                [
                  "InvalidArgument",
                  ""
                ],
                [
                  "Unauthorized",
                  ""
                ],
                [
                  "Forbidden",
                  ""
                ],
                [
                  "NotFound",
                  ""
                ],
                [
                  "ProjectNotFound",
                  ""
                ],
                [
                  "OperationNotFound",
                  ""
                ],
                [
                  "AzureCognitiveSearchNotFound",
                  ""
                ],
                [
                  "AzureCognitiveSearchIndexNotFound",
                  ""
                ],
                [
                  "TooManyRequests",
                  ""
                ],
                [
                  "AzureCognitiveSearchThrottling",
                  ""
                ],
                [
                  "AzureCognitiveSearchIndexLimitReached",
                  ""
                ],
                [
                  "InternalServerError",
                  ""
                ],
                [
                  "ServiceUnavailable",
                  ""
                ],
                [
                  "Timeout",
                  ""
                ],
                [
                  "QuotaExceeded",
                  ""
                ],
                [
                  "Conflict",
                  ""
                ],
                [
                  "Warning",
                  ""
                ]
              ]
            }
          },
          {
            "#name": "innererror",
            "Description": {
              "new": "An object containing more specific information than the current object about\nthe error.",
              "old": "An object containing more specific information than the current object about the error."
            },
            "$properties": [
              {
                "#name": "code",
                "Enum": {
                  "new": [
                    [
                      "InvalidRequest",
                      "Invalid request error"
                    ],
                    [
                      "InvalidParameterValue",
                      "Invalid parameter value error"
                    ],
                    [
                      "KnowledgeBaseNotFound",
                      "Knowledge base not found error"
                    ],
                    [
                      "AzureCognitiveSearchNotFound",
                      "Azure Cognitive Search not found error"
                    ],
                    [
                      "AzureCognitiveSearchThrottling",
                      "Azure Cognitive Search throttling error"
                    ],
                    [
                      "ExtractionFailure",
                      "Extraction failure error"
                    ],
                    [
                      "InvalidRequestBodyFormat",
                      "Invalid request body format error"
                    ],
                    [
                      "EmptyRequest",
                      "Empty request error"
                    ],
                    [
                      "MissingInputDocuments",
                      "Missing input documents error"
                    ],
                    [
                      "InvalidDocument",
                      "Invalid document error"
                    ],
                    [
                      "ModelVersionIncorrect",
                      "Model version incorrect error"
                    ],
                    [
                      "InvalidDocumentBatch",
                      "Invalid document batch error"
                    ],
                    [
                      "UnsupportedLanguageCode",
                      "Unsupported language code error"
                    ],
                    [
                      "InvalidCountryHint",
                      "Invalid country hint error"
                    ]
                  ],
                  "old": [
                    [
                      "InvalidRequest",
                      ""
                    ],
                    [
                      "InvalidParameterValue",
                      ""
                    ],
                    [
                      "KnowledgeBaseNotFound",
                      ""
                    ],
                    [
                      "AzureCognitiveSearchNotFound",
                      ""
                    ],
                    [
                      "AzureCognitiveSearchThrottling",
                      ""
                    ],
                    [
                      "ExtractionFailure",
                      ""
                    ],
                    [
                      "InvalidRequestBodyFormat",
                      ""
                    ],
                    [
                      "EmptyRequest",
                      ""
                    ],
                    [
                      "MissingInputDocuments",
                      ""
                    ],
                    [
                      "InvalidDocument",
                      ""
                    ],
                    [
                      "ModelVersionIncorrect",
                      ""
                    ],
                    [
                      "InvalidDocumentBatch",
                      ""
                    ],
                    [
                      "UnsupportedLanguageCode",
                      ""
                    ],
                    [
                      "InvalidCountryHint",
                      ""
                    ]
                  ]
                }
              }
            ]
          }
        ]
      }
    }
  }
}

⚼ Request

GET:  /authoring/query-knowledgebases/projects/{projectName}/qnas/jobs/{jobId}
{
api-version:
{
Description: The API version to use for this operation. ,
Required: True ,
}
string ,
projectName:
{
Description: Name of the project. ,
Required: True ,
}
string ,
jobId:
{
Description: The job ID. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
createdDateTime:
{
Description: The creation date time of the job. ,
Format: date-time ,
Required: True ,
}
string ,
expirationDateTime:
{
Description: The expiration date time of the job. ,
Format: date-time ,
Required: False ,
}
string ,
jobId:
{
Description: The job ID. ,
Required: True ,
}
string ,
lastUpdatedDateTime:
{
Description: The last date time the job was updated. ,
Format: date-time ,
Required: True ,
}
string ,
status:
{
Description: Job Status. ,
Enum:
{
notStarted: No description available. ,
running: No description available. ,
succeeded: No description available. ,
failed: No description available. ,
cancelled: No description available. ,
cancelling: No description available. ,
partiallyCompleted: No description available. ,
}
,
Required: True ,
}
enum ,
errors:
{
Description: The errors encountered while executing the job. ,
Required: False ,
}
[
{
code:
{
Description: One of a server-defined set of error codes. ,
Required: True ,
}
string ,
message:
{
Description: A human-readable representation of the error. ,
Required: True ,
}
string ,
target:
{
Description: The target of the error. ,
Required: False ,
}
string ,
details:
{
Description: An array of details about specific errors that led to this reported error. ,
Required: False ,
}
[
string ,
]
,
innererror:
{
Description: An object containing more specific information than the current object about the error. ,
Required: False ,
}
{
code:
{
Description: One of a server-defined set of error codes. ,
Required: False ,
}
string ,
innererror:
{
Required: False ,
}
string ,
}
,
}
,
]
,
}

⚐ Response (default)

{
$headers:
{
x-ms-error-code:
{
Description: String error code indicating what went wrong. ,
}
string ,
}
,
$schema:
{
Description: Error response. ,
}
{
error:
{
Description: The error object. ,
Required: True ,
}
{
code:
{
Description: One of a server-defined set of error codes. ,
Enum:
{
InvalidRequest: Invalid request error ,
InvalidArgument: Invalid argument error ,
Unauthorized: Unauthorized access error ,
Forbidden: Forbidden access error ,
NotFound: Not found error ,
ProjectNotFound: Project not found error ,
OperationNotFound: Operation not found error ,
AzureCognitiveSearchNotFound: Azure Cognitive Search not found error ,
AzureCognitiveSearchIndexNotFound: Azure Cognitive Search index not found error ,
TooManyRequests: Too many requests error ,
AzureCognitiveSearchThrottling: Azure Cognitive Search throttling error ,
AzureCognitiveSearchIndexLimitReached: Azure Cognitive Search index limit reached error ,
InternalServerError: Internal server error ,
ServiceUnavailable: Service unavailable error ,
Timeout: Timeout error ,
QuotaExceeded: Quota exceeded error ,
Conflict: Conflict error ,
Warning: Warning error ,
}
,
Required: True ,
}
enum ,
message:
{
Description: A human-readable representation of the error. ,
Required: True ,
}
string ,
target:
{
Description: The target of the error. ,
Required: False ,
}
string ,
details:
{
Description: An array of details about specific errors that led to this reported error. ,
Required: False ,
}
[
string ,
]
,
innererror:
{
Description: An object containing more specific information than the current object about the error. ,
Required: False ,
}
{
code:
{
Description: One of a server-defined set of error codes. ,
Enum:
{
InvalidRequest: Invalid request error ,
InvalidParameterValue: Invalid parameter value error ,
KnowledgeBaseNotFound: Knowledge base not found error ,
AzureCognitiveSearchNotFound: Azure Cognitive Search not found error ,
AzureCognitiveSearchThrottling: Azure Cognitive Search throttling error ,
ExtractionFailure: Extraction failure error ,
InvalidRequestBodyFormat: Invalid request body format error ,
EmptyRequest: Empty request error ,
MissingInputDocuments: Missing input documents error ,
InvalidDocument: Invalid document error ,
ModelVersionIncorrect: Model version incorrect error ,
InvalidDocumentBatch: Invalid document batch error ,
UnsupportedLanguageCode: Unsupported language code error ,
InvalidCountryHint: Invalid country hint error ,
}
,
Required: True ,
}
enum ,
message:
{
Description: Error message. ,
Required: True ,
}
string ,
details:
{
Description: Error details. ,
Required: False ,
}
object ,
target:
{
Description: Error target. ,
Required: False ,
}
string ,
innererror:
{
Required: False ,
}
string ,
}
,
}
,
}
,
}
QuestionAnsweringProjects_GetSources (updated)
Description :  Gets all the sources of a project.
Reference :  Link ¶

⚶ Changes

{
  "#id": "QuestionAnsweringProjects_GetSources",
  "$parameters": [
    {
      "#name": "api-version",
      "Description": {
        "new": "The API version to use for this operation.",
        "old": "Client API version."
      }
    },
    {
      "#name": "projectName",
      "Description": {
        "new": "Name of the project.",
        "old": "The name of the project to use."
      }
    }
  ],
  "$responses": {
    "200": {
      "Description": {
        "new": "Paged collection of QnaSourceRecord items",
        "old": "All QnA sources for the project."
      },
      "$properties": [
        {
          "#name": "value",
          "Description": {
            "new": "The QnaSourceRecord items on this page",
            "old": "Custom sources from which QnAs were extracted or explicitly added to the project."
          },
          "Required": {
            "new": true,
            "old": false
          },
          "$items": {
            "Type": {
              "new": "object",
              "old": "string"
            }
          }
        }
      ]
    },
    "default": {
      "$properties": {
        "error": [
          {
            "#name": "code",
            "Enum": {
              "new": [
                [
                  "InvalidRequest",
                  "Invalid request error"
                ],
                [
                  "InvalidArgument",
                  "Invalid argument error"
                ],
                [
                  "Unauthorized",
                  "Unauthorized access error"
                ],
                [
                  "Forbidden",
                  "Forbidden access error"
                ],
                [
                  "NotFound",
                  "Not found error"
                ],
                [
                  "ProjectNotFound",
                  "Project not found error"
                ],
                [
                  "OperationNotFound",
                  "Operation not found error"
                ],
                [
                  "AzureCognitiveSearchNotFound",
                  "Azure Cognitive Search not found error"
                ],
                [
                  "AzureCognitiveSearchIndexNotFound",
                  "Azure Cognitive Search index not found error"
                ],
                [
                  "TooManyRequests",
                  "Too many requests error"
                ],
                [
                  "AzureCognitiveSearchThrottling",
                  "Azure Cognitive Search throttling error"
                ],
                [
                  "AzureCognitiveSearchIndexLimitReached",
                  "Azure Cognitive Search index limit reached error"
                ],
                [
                  "InternalServerError",
                  "Internal server error"
                ],
                [
                  "ServiceUnavailable",
                  "Service unavailable error"
                ],
                [
                  "Timeout",
                  "Timeout error"
                ],
                [
                  "QuotaExceeded",
                  "Quota exceeded error"
                ],
                [
                  "Conflict",
                  "Conflict error"
                ],
                [
                  "Warning",
                  "Warning error"
                ]
              ],
              "old": [
                [
                  "InvalidRequest",
                  ""
                ],
                [
                  "InvalidArgument",
                  ""
                ],
                [
                  "Unauthorized",
                  ""
                ],
                [
                  "Forbidden",
                  ""
                ],
                [
                  "NotFound",
                  ""
                ],
                [
                  "ProjectNotFound",
                  ""
                ],
                [
                  "OperationNotFound",
                  ""
                ],
                [
                  "AzureCognitiveSearchNotFound",
                  ""
                ],
                [
                  "AzureCognitiveSearchIndexNotFound",
                  ""
                ],
                [
                  "TooManyRequests",
                  ""
                ],
                [
                  "AzureCognitiveSearchThrottling",
                  ""
                ],
                [
                  "AzureCognitiveSearchIndexLimitReached",
                  ""
                ],
                [
                  "InternalServerError",
                  ""
                ],
                [
                  "ServiceUnavailable",
                  ""
                ],
                [
                  "Timeout",
                  ""
                ],
                [
                  "QuotaExceeded",
                  ""
                ],
                [
                  "Conflict",
                  ""
                ],
                [
                  "Warning",
                  ""
                ]
              ]
            }
          },
          {
            "#name": "innererror",
            "Description": {
              "new": "An object containing more specific information than the current object about\nthe error.",
              "old": "An object containing more specific information than the current object about the error."
            },
            "$properties": [
              {
                "#name": "code",
                "Enum": {
                  "new": [
                    [
                      "InvalidRequest",
                      "Invalid request error"
                    ],
                    [
                      "InvalidParameterValue",
                      "Invalid parameter value error"
                    ],
                    [
                      "KnowledgeBaseNotFound",
                      "Knowledge base not found error"
                    ],
                    [
                      "AzureCognitiveSearchNotFound",
                      "Azure Cognitive Search not found error"
                    ],
                    [
                      "AzureCognitiveSearchThrottling",
                      "Azure Cognitive Search throttling error"
                    ],
                    [
                      "ExtractionFailure",
                      "Extraction failure error"
                    ],
                    [
                      "InvalidRequestBodyFormat",
                      "Invalid request body format error"
                    ],
                    [
                      "EmptyRequest",
                      "Empty request error"
                    ],
                    [
                      "MissingInputDocuments",
                      "Missing input documents error"
                    ],
                    [
                      "InvalidDocument",
                      "Invalid document error"
                    ],
                    [
                      "ModelVersionIncorrect",
                      "Model version incorrect error"
                    ],
                    [
                      "InvalidDocumentBatch",
                      "Invalid document batch error"
                    ],
                    [
                      "UnsupportedLanguageCode",
                      "Unsupported language code error"
                    ],
                    [
                      "InvalidCountryHint",
                      "Invalid country hint error"
                    ]
                  ],
                  "old": [
                    [
                      "InvalidRequest",
                      ""
                    ],
                    [
                      "InvalidParameterValue",
                      ""
                    ],
                    [
                      "KnowledgeBaseNotFound",
                      ""
                    ],
                    [
                      "AzureCognitiveSearchNotFound",
                      ""
                    ],
                    [
                      "AzureCognitiveSearchThrottling",
                      ""
                    ],
                    [
                      "ExtractionFailure",
                      ""
                    ],
                    [
                      "InvalidRequestBodyFormat",
                      ""
                    ],
                    [
                      "EmptyRequest",
                      ""
                    ],
                    [
                      "MissingInputDocuments",
                      ""
                    ],
                    [
                      "InvalidDocument",
                      ""
                    ],
                    [
                      "ModelVersionIncorrect",
                      ""
                    ],
                    [
                      "InvalidDocumentBatch",
                      ""
                    ],
                    [
                      "UnsupportedLanguageCode",
                      ""
                    ],
                    [
                      "InvalidCountryHint",
                      ""
                    ]
                  ]
                }
              }
            ]
          }
        ]
      }
    }
  }
}

⚼ Request

GET:  /authoring/query-knowledgebases/projects/{projectName}/sources
{
api-version:
{
Description: The API version to use for this operation. ,
Required: True ,
}
string ,
projectName:
{
Description: Name of the project. ,
Required: True ,
}
string ,
top:
{
Description: The maximum number of resources to return from the collection. ,
Format: int32 ,
Required: False ,
}
integer ,
skip:
{
Description: An offset into the collection of the first resource to be returned. ,
Format: int32 ,
Required: False ,
}
integer ,
maxpagesize:
{
Description: The maximum number of resources to include in a single response. ,
Format: int32 ,
Required: False ,
}
integer ,
}

⚐ Response (200)

{
value:
{
Description: The QnaSourceRecord items on this page ,
Required: True ,
}
[
{
displayName:
{
Description: Friendly name of the Source. ,
Required: False ,
}
string ,
source:
{
Description: Unique source identifier. Name of the file if it's a 'file' source; otherwise, the complete URL if it's a 'url' source. ,
Required: True ,
}
string ,
sourceUri:
{
Description: URI location for the file or url. ,
Format: uri ,
Required: True ,
}
string ,
sourceKind:
{
Description: Supported source types. ,
Enum:
{
file: File Source. ,
url: URI Source. ,
}
,
Required: True ,
}
enum ,
contentStructureKind:
{
Description: Content structure type for sources. ,
Enum:
{
unstructured: Unstructured. ,
}
,
Required: False ,
}
enum ,
lastUpdatedDateTime:
{
Description: Date-time when the QnA was last updated. ,
Format: date-time ,
Required: False ,
}
string ,
}
,
]
,
nextLink:
{
Description: The link to the next page of items ,
Format: uri ,
Required: False ,
}
string ,
}

⚐ Response (default)

{
$headers:
{
x-ms-error-code:
{
Description: String error code indicating what went wrong. ,
}
string ,
}
,
$schema:
{
Description: Error response. ,
}
{
error:
{
Description: The error object. ,
Required: True ,
}
{
code:
{
Description: One of a server-defined set of error codes. ,
Enum:
{
InvalidRequest: Invalid request error ,
InvalidArgument: Invalid argument error ,
Unauthorized: Unauthorized access error ,
Forbidden: Forbidden access error ,
NotFound: Not found error ,
ProjectNotFound: Project not found error ,
OperationNotFound: Operation not found error ,
AzureCognitiveSearchNotFound: Azure Cognitive Search not found error ,
AzureCognitiveSearchIndexNotFound: Azure Cognitive Search index not found error ,
TooManyRequests: Too many requests error ,
AzureCognitiveSearchThrottling: Azure Cognitive Search throttling error ,
AzureCognitiveSearchIndexLimitReached: Azure Cognitive Search index limit reached error ,
InternalServerError: Internal server error ,
ServiceUnavailable: Service unavailable error ,
Timeout: Timeout error ,
QuotaExceeded: Quota exceeded error ,
Conflict: Conflict error ,
Warning: Warning error ,
}
,
Required: True ,
}
enum ,
message:
{
Description: A human-readable representation of the error. ,
Required: True ,
}
string ,
target:
{
Description: The target of the error. ,
Required: False ,
}
string ,
details:
{
Description: An array of details about specific errors that led to this reported error. ,
Required: False ,
}
[
string ,
]
,
innererror:
{
Description: An object containing more specific information than the current object about the error. ,
Required: False ,
}
{
code:
{
Description: One of a server-defined set of error codes. ,
Enum:
{
InvalidRequest: Invalid request error ,
InvalidParameterValue: Invalid parameter value error ,
KnowledgeBaseNotFound: Knowledge base not found error ,
AzureCognitiveSearchNotFound: Azure Cognitive Search not found error ,
AzureCognitiveSearchThrottling: Azure Cognitive Search throttling error ,
ExtractionFailure: Extraction failure error ,
InvalidRequestBodyFormat: Invalid request body format error ,
EmptyRequest: Empty request error ,
MissingInputDocuments: Missing input documents error ,
InvalidDocument: Invalid document error ,
ModelVersionIncorrect: Model version incorrect error ,
InvalidDocumentBatch: Invalid document batch error ,
UnsupportedLanguageCode: Unsupported language code error ,
InvalidCountryHint: Invalid country hint error ,
}
,
Required: True ,
}
enum ,
message:
{
Description: Error message. ,
Required: True ,
}
string ,
details:
{
Description: Error details. ,
Required: False ,
}
object ,
target:
{
Description: Error target. ,
Required: False ,
}
string ,
innererror:
{
Required: False ,
}
string ,
}
,
}
,
}
,
}
QuestionAnsweringProjects_UpdateSources (updated)
Description :  Updates the sources of a project.
Reference :  Link ¶

⚶ Changes

{
  "#id": "QuestionAnsweringProjects_UpdateSources",
  "$parameters": [
    {
      "#name": "api-version",
      "Description": {
        "new": "The API version to use for this operation.",
        "old": "Client API version."
      }
    },
    {
      "body": {
        "$items": {
          "$properties": [
            {
              "#name": "op",
              "Enum": {
                "new": [
                  [
                    "add",
                    "Add operation."
                  ],
                  [
                    "delete",
                    "Delete operation."
                  ],
                  [
                    "replace",
                    "Replace operation."
                  ]
                ],
                "old": [
                  [
                    "add",
                    ""
                  ],
                  [
                    "delete",
                    ""
                  ],
                  [
                    "replace",
                    ""
                  ]
                ]
              }
            },
            {
              "#name": "value",
              "Type": {
                "new": "object",
                "old": "string"
              }
            }
          ]
        }
      }
    }
  ],
  "$responses": {
    "default": {
      "$properties": {
        "error": [
          {
            "#name": "code",
            "Enum": {
              "new": [
                [
                  "InvalidRequest",
                  "Invalid request error"
                ],
                [
                  "InvalidArgument",
                  "Invalid argument error"
                ],
                [
                  "Unauthorized",
                  "Unauthorized access error"
                ],
                [
                  "Forbidden",
                  "Forbidden access error"
                ],
                [
                  "NotFound",
                  "Not found error"
                ],
                [
                  "ProjectNotFound",
                  "Project not found error"
                ],
                [
                  "OperationNotFound",
                  "Operation not found error"
                ],
                [
                  "AzureCognitiveSearchNotFound",
                  "Azure Cognitive Search not found error"
                ],
                [
                  "AzureCognitiveSearchIndexNotFound",
                  "Azure Cognitive Search index not found error"
                ],
                [
                  "TooManyRequests",
                  "Too many requests error"
                ],
                [
                  "AzureCognitiveSearchThrottling",
                  "Azure Cognitive Search throttling error"
                ],
                [
                  "AzureCognitiveSearchIndexLimitReached",
                  "Azure Cognitive Search index limit reached error"
                ],
                [
                  "InternalServerError",
                  "Internal server error"
                ],
                [
                  "ServiceUnavailable",
                  "Service unavailable error"
                ],
                [
                  "Timeout",
                  "Timeout error"
                ],
                [
                  "QuotaExceeded",
                  "Quota exceeded error"
                ],
                [
                  "Conflict",
                  "Conflict error"
                ],
                [
                  "Warning",
                  "Warning error"
                ]
              ],
              "old": [
                [
                  "InvalidRequest",
                  ""
                ],
                [
                  "InvalidArgument",
                  ""
                ],
                [
                  "Unauthorized",
                  ""
                ],
                [
                  "Forbidden",
                  ""
                ],
                [
                  "NotFound",
                  ""
                ],
                [
                  "ProjectNotFound",
                  ""
                ],
                [
                  "OperationNotFound",
                  ""
                ],
                [
                  "AzureCognitiveSearchNotFound",
                  ""
                ],
                [
                  "AzureCognitiveSearchIndexNotFound",
                  ""
                ],
                [
                  "TooManyRequests",
                  ""
                ],
                [
                  "AzureCognitiveSearchThrottling",
                  ""
                ],
                [
                  "AzureCognitiveSearchIndexLimitReached",
                  ""
                ],
                [
                  "InternalServerError",
                  ""
                ],
                [
                  "ServiceUnavailable",
                  ""
                ],
                [
                  "Timeout",
                  ""
                ],
                [
                  "QuotaExceeded",
                  ""
                ],
                [
                  "Conflict",
                  ""
                ],
                [
                  "Warning",
                  ""
                ]
              ]
            }
          },
          {
            "#name": "innererror",
            "Description": {
              "new": "An object containing more specific information than the current object about\nthe error.",
              "old": "An object containing more specific information than the current object about the error."
            },
            "$properties": [
              {
                "#name": "code",
                "Enum": {
                  "new": [
                    [
                      "InvalidRequest",
                      "Invalid request error"
                    ],
                    [
                      "InvalidParameterValue",
                      "Invalid parameter value error"
                    ],
                    [
                      "KnowledgeBaseNotFound",
                      "Knowledge base not found error"
                    ],
                    [
                      "AzureCognitiveSearchNotFound",
                      "Azure Cognitive Search not found error"
                    ],
                    [
                      "AzureCognitiveSearchThrottling",
                      "Azure Cognitive Search throttling error"
                    ],
                    [
                      "ExtractionFailure",
                      "Extraction failure error"
                    ],
                    [
                      "InvalidRequestBodyFormat",
                      "Invalid request body format error"
                    ],
                    [
                      "EmptyRequest",
                      "Empty request error"
                    ],
                    [
                      "MissingInputDocuments",
                      "Missing input documents error"
                    ],
                    [
                      "InvalidDocument",
                      "Invalid document error"
                    ],
                    [
                      "ModelVersionIncorrect",
                      "Model version incorrect error"
                    ],
                    [
                      "InvalidDocumentBatch",
                      "Invalid document batch error"
                    ],
                    [
                      "UnsupportedLanguageCode",
                      "Unsupported language code error"
                    ],
                    [
                      "InvalidCountryHint",
                      "Invalid country hint error"
                    ]
                  ],
                  "old": [
                    [
                      "InvalidRequest",
                      ""
                    ],
                    [
                      "InvalidParameterValue",
                      ""
                    ],
                    [
                      "KnowledgeBaseNotFound",
                      ""
                    ],
                    [
                      "AzureCognitiveSearchNotFound",
                      ""
                    ],
                    [
                      "AzureCognitiveSearchThrottling",
                      ""
                    ],
                    [
                      "ExtractionFailure",
                      ""
                    ],
                    [
                      "InvalidRequestBodyFormat",
                      ""
                    ],
                    [
                      "EmptyRequest",
                      ""
                    ],
                    [
                      "MissingInputDocuments",
                      ""
                    ],
                    [
                      "InvalidDocument",
                      ""
                    ],
                    [
                      "ModelVersionIncorrect",
                      ""
                    ],
                    [
                      "InvalidDocumentBatch",
                      ""
                    ],
                    [
                      "UnsupportedLanguageCode",
                      ""
                    ],
                    [
                      "InvalidCountryHint",
                      ""
                    ]
                  ]
                }
              }
            ]
          }
        ]
      }
    }
  }
}

⚼ Request

PATCH:  /authoring/query-knowledgebases/projects/{projectName}/sources
{
api-version:
{
Description: The API version to use for this operation. ,
Required: True ,
}
string ,
projectName:
{
Description: The name of the project to use. ,
Required: True ,
}
string ,
body:
{
Description: Update sources parameters of a project. ,
Required: True ,
}
{
op:
{
Description: Update operation type for assets. ,
Enum:
{
add: Add operation. ,
delete: Delete operation. ,
replace: Replace operation. ,
}
,
Required: True ,
}
enum ,
value:
{
Description: Update source record. ,
Required: True ,
}
{
displayName:
{
Description: Friendly name of the Source. ,
Required: False ,
}
string ,
source:
{
Description: Unique source identifier. Name of the file if it's a 'file' source; otherwise, the complete URL if it's a 'url' source. ,
Required: True ,
}
string ,
sourceUri:
{
Description: URI location for the file or url. ,
Format: uri ,
Required: True ,
}
string ,
sourceKind:
{
Description: Supported source types. ,
Enum:
{
file: File Source. ,
url: URI Source. ,
}
,
Required: True ,
}
enum ,
contentStructureKind:
{
Description: Content structure type for sources. ,
Enum:
{
unstructured: Unstructured. ,
}
,
Required: False ,
}
enum ,
refresh:
{
Description: Boolean flag used to refresh data from the Source. ,
Required: False ,
}
boolean ,
}
,
}
,
}

⚐ Response (202)

{
operation-location:
{
Description: The location for monitoring the operation state. ,
}
string ,
}

⚐ Response (default)

{
$headers:
{
x-ms-error-code:
{
Description: String error code indicating what went wrong. ,
}
string ,
}
,
$schema:
{
Description: Error response. ,
}
{
error:
{
Description: The error object. ,
Required: True ,
}
{
code:
{
Description: One of a server-defined set of error codes. ,
Enum:
{
InvalidRequest: Invalid request error ,
InvalidArgument: Invalid argument error ,
Unauthorized: Unauthorized access error ,
Forbidden: Forbidden access error ,
NotFound: Not found error ,
ProjectNotFound: Project not found error ,
OperationNotFound: Operation not found error ,
AzureCognitiveSearchNotFound: Azure Cognitive Search not found error ,
AzureCognitiveSearchIndexNotFound: Azure Cognitive Search index not found error ,
TooManyRequests: Too many requests error ,
AzureCognitiveSearchThrottling: Azure Cognitive Search throttling error ,
AzureCognitiveSearchIndexLimitReached: Azure Cognitive Search index limit reached error ,
InternalServerError: Internal server error ,
ServiceUnavailable: Service unavailable error ,
Timeout: Timeout error ,
QuotaExceeded: Quota exceeded error ,
Conflict: Conflict error ,
Warning: Warning error ,
}
,
Required: True ,
}
enum ,
message:
{
Description: A human-readable representation of the error. ,
Required: True ,
}
string ,
target:
{
Description: The target of the error. ,
Required: False ,
}
string ,
details:
{
Description: An array of details about specific errors that led to this reported error. ,
Required: False ,
}
[
string ,
]
,
innererror:
{
Description: An object containing more specific information than the current object about the error. ,
Required: False ,
}
{
code:
{
Description: One of a server-defined set of error codes. ,
Enum:
{
InvalidRequest: Invalid request error ,
InvalidParameterValue: Invalid parameter value error ,
KnowledgeBaseNotFound: Knowledge base not found error ,
AzureCognitiveSearchNotFound: Azure Cognitive Search not found error ,
AzureCognitiveSearchThrottling: Azure Cognitive Search throttling error ,
ExtractionFailure: Extraction failure error ,
InvalidRequestBodyFormat: Invalid request body format error ,
EmptyRequest: Empty request error ,
MissingInputDocuments: Missing input documents error ,
InvalidDocument: Invalid document error ,
ModelVersionIncorrect: Model version incorrect error ,
InvalidDocumentBatch: Invalid document batch error ,
UnsupportedLanguageCode: Unsupported language code error ,
InvalidCountryHint: Invalid country hint error ,
}
,
Required: True ,
}
enum ,
message:
{
Description: Error message. ,
Required: True ,
}
string ,
details:
{
Description: Error details. ,
Required: False ,
}
object ,
target:
{
Description: Error target. ,
Required: False ,
}
string ,
innererror:
{
Required: False ,
}
string ,
}
,
}
,
}
,
}
QuestionAnsweringProjects_GetUpdateSourcesStatus (updated)
Description :  Gets the status of update sources job.
Reference :  Link ¶

⚶ Changes

{
  "#id": "QuestionAnsweringProjects_GetUpdateSourcesStatus",
  "$parameters": [
    {
      "#name": "api-version",
      "Description": {
        "new": "The API version to use for this operation.",
        "old": "Client API version."
      }
    },
    {
      "#name": "projectName",
      "Description": {
        "new": "Name of the project.",
        "old": "The name of the project to use."
      }
    },
    {
      "#name": "jobId",
      "Description": {
        "new": "The job ID.",
        "old": "Job ID."
      }
    }
  ],
  "$responses": {
    "200": {
      "Type": {
        "new": "object",
        "old": "string"
      }
    },
    "default": {
      "$properties": {
        "error": [
          {
            "#name": "code",
            "Enum": {
              "new": [
                [
                  "InvalidRequest",
                  "Invalid request error"
                ],
                [
                  "InvalidArgument",
                  "Invalid argument error"
                ],
                [
                  "Unauthorized",
                  "Unauthorized access error"
                ],
                [
                  "Forbidden",
                  "Forbidden access error"
                ],
                [
                  "NotFound",
                  "Not found error"
                ],
                [
                  "ProjectNotFound",
                  "Project not found error"
                ],
                [
                  "OperationNotFound",
                  "Operation not found error"
                ],
                [
                  "AzureCognitiveSearchNotFound",
                  "Azure Cognitive Search not found error"
                ],
                [
                  "AzureCognitiveSearchIndexNotFound",
                  "Azure Cognitive Search index not found error"
                ],
                [
                  "TooManyRequests",
                  "Too many requests error"
                ],
                [
                  "AzureCognitiveSearchThrottling",
                  "Azure Cognitive Search throttling error"
                ],
                [
                  "AzureCognitiveSearchIndexLimitReached",
                  "Azure Cognitive Search index limit reached error"
                ],
                [
                  "InternalServerError",
                  "Internal server error"
                ],
                [
                  "ServiceUnavailable",
                  "Service unavailable error"
                ],
                [
                  "Timeout",
                  "Timeout error"
                ],
                [
                  "QuotaExceeded",
                  "Quota exceeded error"
                ],
                [
                  "Conflict",
                  "Conflict error"
                ],
                [
                  "Warning",
                  "Warning error"
                ]
              ],
              "old": [
                [
                  "InvalidRequest",
                  ""
                ],
                [
                  "InvalidArgument",
                  ""
                ],
                [
                  "Unauthorized",
                  ""
                ],
                [
                  "Forbidden",
                  ""
                ],
                [
                  "NotFound",
                  ""
                ],
                [
                  "ProjectNotFound",
                  ""
                ],
                [
                  "OperationNotFound",
                  ""
                ],
                [
                  "AzureCognitiveSearchNotFound",
                  ""
                ],
                [
                  "AzureCognitiveSearchIndexNotFound",
                  ""
                ],
                [
                  "TooManyRequests",
                  ""
                ],
                [
                  "AzureCognitiveSearchThrottling",
                  ""
                ],
                [
                  "AzureCognitiveSearchIndexLimitReached",
                  ""
                ],
                [
                  "InternalServerError",
                  ""
                ],
                [
                  "ServiceUnavailable",
                  ""
                ],
                [
                  "Timeout",
                  ""
                ],
                [
                  "QuotaExceeded",
                  ""
                ],
                [
                  "Conflict",
                  ""
                ],
                [
                  "Warning",
                  ""
                ]
              ]
            }
          },
          {
            "#name": "innererror",
            "Description": {
              "new": "An object containing more specific information than the current object about\nthe error.",
              "old": "An object containing more specific information than the current object about the error."
            },
            "$properties": [
              {
                "#name": "code",
                "Enum": {
                  "new": [
                    [
                      "InvalidRequest",
                      "Invalid request error"
                    ],
                    [
                      "InvalidParameterValue",
                      "Invalid parameter value error"
                    ],
                    [
                      "KnowledgeBaseNotFound",
                      "Knowledge base not found error"
                    ],
                    [
                      "AzureCognitiveSearchNotFound",
                      "Azure Cognitive Search not found error"
                    ],
                    [
                      "AzureCognitiveSearchThrottling",
                      "Azure Cognitive Search throttling error"
                    ],
                    [
                      "ExtractionFailure",
                      "Extraction failure error"
                    ],
                    [
                      "InvalidRequestBodyFormat",
                      "Invalid request body format error"
                    ],
                    [
                      "EmptyRequest",
                      "Empty request error"
                    ],
                    [
                      "MissingInputDocuments",
                      "Missing input documents error"
                    ],
                    [
                      "InvalidDocument",
                      "Invalid document error"
                    ],
                    [
                      "ModelVersionIncorrect",
                      "Model version incorrect error"
                    ],
                    [
                      "InvalidDocumentBatch",
                      "Invalid document batch error"
                    ],
                    [
                      "UnsupportedLanguageCode",
                      "Unsupported language code error"
                    ],
                    [
                      "InvalidCountryHint",
                      "Invalid country hint error"
                    ]
                  ],
                  "old": [
                    [
                      "InvalidRequest",
                      ""
                    ],
                    [
                      "InvalidParameterValue",
                      ""
                    ],
                    [
                      "KnowledgeBaseNotFound",
                      ""
                    ],
                    [
                      "AzureCognitiveSearchNotFound",
                      ""
                    ],
                    [
                      "AzureCognitiveSearchThrottling",
                      ""
                    ],
                    [
                      "ExtractionFailure",
                      ""
                    ],
                    [
                      "InvalidRequestBodyFormat",
                      ""
                    ],
                    [
                      "EmptyRequest",
                      ""
                    ],
                    [
                      "MissingInputDocuments",
                      ""
                    ],
                    [
                      "InvalidDocument",
                      ""
                    ],
                    [
                      "ModelVersionIncorrect",
                      ""
                    ],
                    [
                      "InvalidDocumentBatch",
                      ""
                    ],
                    [
                      "UnsupportedLanguageCode",
                      ""
                    ],
                    [
                      "InvalidCountryHint",
                      ""
                    ]
                  ]
                }
              }
            ]
          }
        ]
      }
    }
  }
}

⚼ Request

GET:  /authoring/query-knowledgebases/projects/{projectName}/sources/jobs/{jobId}
{
api-version:
{
Description: The API version to use for this operation. ,
Required: True ,
}
string ,
projectName:
{
Description: Name of the project. ,
Required: True ,
}
string ,
jobId:
{
Description: The job ID. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
createdDateTime:
{
Description: The creation date time of the job. ,
Format: date-time ,
Required: True ,
}
string ,
expirationDateTime:
{
Description: The expiration date time of the job. ,
Format: date-time ,
Required: False ,
}
string ,
jobId:
{
Description: The job ID. ,
Required: True ,
}
string ,
lastUpdatedDateTime:
{
Description: The last date time the job was updated. ,
Format: date-time ,
Required: True ,
}
string ,
status:
{
Description: Job Status. ,
Enum:
{
notStarted: No description available. ,
running: No description available. ,
succeeded: No description available. ,
failed: No description available. ,
cancelled: No description available. ,
cancelling: No description available. ,
partiallyCompleted: No description available. ,
}
,
Required: True ,
}
enum ,
errors:
{
Description: The errors encountered while executing the job. ,
Required: False ,
}
[
{
code:
{
Description: One of a server-defined set of error codes. ,
Required: True ,
}
string ,
message:
{
Description: A human-readable representation of the error. ,
Required: True ,
}
string ,
target:
{
Description: The target of the error. ,
Required: False ,
}
string ,
details:
{
Description: An array of details about specific errors that led to this reported error. ,
Required: False ,
}
[
string ,
]
,
innererror:
{
Description: An object containing more specific information than the current object about the error. ,
Required: False ,
}
{
code:
{
Description: One of a server-defined set of error codes. ,
Required: False ,
}
string ,
innererror:
{
Required: False ,
}
string ,
}
,
}
,
]
,
}

⚐ Response (default)

{
$headers:
{
x-ms-error-code:
{
Description: String error code indicating what went wrong. ,
}
string ,
}
,
$schema:
{
Description: Error response. ,
}
{
error:
{
Description: The error object. ,
Required: True ,
}
{
code:
{
Description: One of a server-defined set of error codes. ,
Enum:
{
InvalidRequest: Invalid request error ,
InvalidArgument: Invalid argument error ,
Unauthorized: Unauthorized access error ,
Forbidden: Forbidden access error ,
NotFound: Not found error ,
ProjectNotFound: Project not found error ,
OperationNotFound: Operation not found error ,
AzureCognitiveSearchNotFound: Azure Cognitive Search not found error ,
AzureCognitiveSearchIndexNotFound: Azure Cognitive Search index not found error ,
TooManyRequests: Too many requests error ,
AzureCognitiveSearchThrottling: Azure Cognitive Search throttling error ,
AzureCognitiveSearchIndexLimitReached: Azure Cognitive Search index limit reached error ,
InternalServerError: Internal server error ,
ServiceUnavailable: Service unavailable error ,
Timeout: Timeout error ,
QuotaExceeded: Quota exceeded error ,
Conflict: Conflict error ,
Warning: Warning error ,
}
,
Required: True ,
}
enum ,
message:
{
Description: A human-readable representation of the error. ,
Required: True ,
}
string ,
target:
{
Description: The target of the error. ,
Required: False ,
}
string ,
details:
{
Description: An array of details about specific errors that led to this reported error. ,
Required: False ,
}
[
string ,
]
,
innererror:
{
Description: An object containing more specific information than the current object about the error. ,
Required: False ,
}
{
code:
{
Description: One of a server-defined set of error codes. ,
Enum:
{
InvalidRequest: Invalid request error ,
InvalidParameterValue: Invalid parameter value error ,
KnowledgeBaseNotFound: Knowledge base not found error ,
AzureCognitiveSearchNotFound: Azure Cognitive Search not found error ,
AzureCognitiveSearchThrottling: Azure Cognitive Search throttling error ,
ExtractionFailure: Extraction failure error ,
InvalidRequestBodyFormat: Invalid request body format error ,
EmptyRequest: Empty request error ,
MissingInputDocuments: Missing input documents error ,
InvalidDocument: Invalid document error ,
ModelVersionIncorrect: Model version incorrect error ,
InvalidDocumentBatch: Invalid document batch error ,
UnsupportedLanguageCode: Unsupported language code error ,
InvalidCountryHint: Invalid country hint error ,
}
,
Required: True ,
}
enum ,
message:
{
Description: Error message. ,
Required: True ,
}
string ,
details:
{
Description: Error details. ,
Required: False ,
}
object ,
target:
{
Description: Error target. ,
Required: False ,
}
string ,
innererror:
{
Required: False ,
}
string ,
}
,
}
,
}
,
}
QuestionAnsweringProjects_GetSynonyms (updated)
Description :  Gets all the synonyms of a project.
Reference :  Link ¶

⚶ Changes

{
  "#id": "QuestionAnsweringProjects_GetSynonyms",
  "$parameters": [
    {
      "#name": "api-version",
      "Description": {
        "new": "The API version to use for this operation.",
        "old": "Client API version."
      }
    },
    {
      "#name": "projectName",
      "Description": {
        "new": "Name of the project.",
        "old": "The name of the project to use."
      }
    }
  ],
  "$responses": {
    "200": {
      "Description": {
        "new": "Paged collection of WordAlterations items",
        "old": "All synonym assets for this project."
      },
      "$properties": [
        {
          "#name": "value",
          "Description": {
            "new": "The WordAlterations items on this page",
            "old": "Collection of synonyms."
          },
          "Required": {
            "new": true,
            "old": false
          }
        }
      ]
    },
    "default": {
      "$properties": {
        "error": [
          {
            "#name": "code",
            "Enum": {
              "new": [
                [
                  "InvalidRequest",
                  "Invalid request error"
                ],
                [
                  "InvalidArgument",
                  "Invalid argument error"
                ],
                [
                  "Unauthorized",
                  "Unauthorized access error"
                ],
                [
                  "Forbidden",
                  "Forbidden access error"
                ],
                [
                  "NotFound",
                  "Not found error"
                ],
                [
                  "ProjectNotFound",
                  "Project not found error"
                ],
                [
                  "OperationNotFound",
                  "Operation not found error"
                ],
                [
                  "AzureCognitiveSearchNotFound",
                  "Azure Cognitive Search not found error"
                ],
                [
                  "AzureCognitiveSearchIndexNotFound",
                  "Azure Cognitive Search index not found error"
                ],
                [
                  "TooManyRequests",
                  "Too many requests error"
                ],
                [
                  "AzureCognitiveSearchThrottling",
                  "Azure Cognitive Search throttling error"
                ],
                [
                  "AzureCognitiveSearchIndexLimitReached",
                  "Azure Cognitive Search index limit reached error"
                ],
                [
                  "InternalServerError",
                  "Internal server error"
                ],
                [
                  "ServiceUnavailable",
                  "Service unavailable error"
                ],
                [
                  "Timeout",
                  "Timeout error"
                ],
                [
                  "QuotaExceeded",
                  "Quota exceeded error"
                ],
                [
                  "Conflict",
                  "Conflict error"
                ],
                [
                  "Warning",
                  "Warning error"
                ]
              ],
              "old": [
                [
                  "InvalidRequest",
                  ""
                ],
                [
                  "InvalidArgument",
                  ""
                ],
                [
                  "Unauthorized",
                  ""
                ],
                [
                  "Forbidden",
                  ""
                ],
                [
                  "NotFound",
                  ""
                ],
                [
                  "ProjectNotFound",
                  ""
                ],
                [
                  "OperationNotFound",
                  ""
                ],
                [
                  "AzureCognitiveSearchNotFound",
                  ""
                ],
                [
                  "AzureCognitiveSearchIndexNotFound",
                  ""
                ],
                [
                  "TooManyRequests",
                  ""
                ],
                [
                  "AzureCognitiveSearchThrottling",
                  ""
                ],
                [
                  "AzureCognitiveSearchIndexLimitReached",
                  ""
                ],
                [
                  "InternalServerError",
                  ""
                ],
                [
                  "ServiceUnavailable",
                  ""
                ],
                [
                  "Timeout",
                  ""
                ],
                [
                  "QuotaExceeded",
                  ""
                ],
                [
                  "Conflict",
                  ""
                ],
                [
                  "Warning",
                  ""
                ]
              ]
            }
          },
          {
            "#name": "innererror",
            "Description": {
              "new": "An object containing more specific information than the current object about\nthe error.",
              "old": "An object containing more specific information than the current object about the error."
            },
            "$properties": [
              {
                "#name": "code",
                "Enum": {
                  "new": [
                    [
                      "InvalidRequest",
                      "Invalid request error"
                    ],
                    [
                      "InvalidParameterValue",
                      "Invalid parameter value error"
                    ],
                    [
                      "KnowledgeBaseNotFound",
                      "Knowledge base not found error"
                    ],
                    [
                      "AzureCognitiveSearchNotFound",
                      "Azure Cognitive Search not found error"
                    ],
                    [
                      "AzureCognitiveSearchThrottling",
                      "Azure Cognitive Search throttling error"
                    ],
                    [
                      "ExtractionFailure",
                      "Extraction failure error"
                    ],
                    [
                      "InvalidRequestBodyFormat",
                      "Invalid request body format error"
                    ],
                    [
                      "EmptyRequest",
                      "Empty request error"
                    ],
                    [
                      "MissingInputDocuments",
                      "Missing input documents error"
                    ],
                    [
                      "InvalidDocument",
                      "Invalid document error"
                    ],
                    [
                      "ModelVersionIncorrect",
                      "Model version incorrect error"
                    ],
                    [
                      "InvalidDocumentBatch",
                      "Invalid document batch error"
                    ],
                    [
                      "UnsupportedLanguageCode",
                      "Unsupported language code error"
                    ],
                    [
                      "InvalidCountryHint",
                      "Invalid country hint error"
                    ]
                  ],
                  "old": [
                    [
                      "InvalidRequest",
                      ""
                    ],
                    [
                      "InvalidParameterValue",
                      ""
                    ],
                    [
                      "KnowledgeBaseNotFound",
                      ""
                    ],
                    [
                      "AzureCognitiveSearchNotFound",
                      ""
                    ],
                    [
                      "AzureCognitiveSearchThrottling",
                      ""
                    ],
                    [
                      "ExtractionFailure",
                      ""
                    ],
                    [
                      "InvalidRequestBodyFormat",
                      ""
                    ],
                    [
                      "EmptyRequest",
                      ""
                    ],
                    [
                      "MissingInputDocuments",
                      ""
                    ],
                    [
                      "InvalidDocument",
                      ""
                    ],
                    [
                      "ModelVersionIncorrect",
                      ""
                    ],
                    [
                      "InvalidDocumentBatch",
                      ""
                    ],
                    [
                      "UnsupportedLanguageCode",
                      ""
                    ],
                    [
                      "InvalidCountryHint",
                      ""
                    ]
                  ]
                }
              }
            ]
          }
        ]
      }
    }
  }
}

⚼ Request

GET:  /authoring/query-knowledgebases/projects/{projectName}/synonyms
{
api-version:
{
Description: The API version to use for this operation. ,
Required: True ,
}
string ,
projectName:
{
Description: Name of the project. ,
Required: True ,
}
string ,
top:
{
Description: The maximum number of resources to return from the collection. ,
Format: int32 ,
Required: False ,
}
integer ,
skip:
{
Description: An offset into the collection of the first resource to be returned. ,
Format: int32 ,
Required: False ,
}
integer ,
maxpagesize:
{
Description: The maximum number of resources to include in a single response. ,
Format: int32 ,
Required: False ,
}
integer ,
}

⚐ Response (200)

{
value:
{
Description: The WordAlterations items on this page ,
Required: True ,
}
[
{
alterations:
{
Description: Collection of word alterations. ,
Required: True ,
}
[
string ,
]
,
}
,
]
,
nextLink:
{
Description: The link to the next page of items ,
Format: uri ,
Required: False ,
}
string ,
}

⚐ Response (default)

{
$headers:
{
x-ms-error-code:
{
Description: String error code indicating what went wrong. ,
}
string ,
}
,
$schema:
{
Description: Error response. ,
}
{
error:
{
Description: The error object. ,
Required: True ,
}
{
code:
{
Description: One of a server-defined set of error codes. ,
Enum:
{
InvalidRequest: Invalid request error ,
InvalidArgument: Invalid argument error ,
Unauthorized: Unauthorized access error ,
Forbidden: Forbidden access error ,
NotFound: Not found error ,
ProjectNotFound: Project not found error ,
OperationNotFound: Operation not found error ,
AzureCognitiveSearchNotFound: Azure Cognitive Search not found error ,
AzureCognitiveSearchIndexNotFound: Azure Cognitive Search index not found error ,
TooManyRequests: Too many requests error ,
AzureCognitiveSearchThrottling: Azure Cognitive Search throttling error ,
AzureCognitiveSearchIndexLimitReached: Azure Cognitive Search index limit reached error ,
InternalServerError: Internal server error ,
ServiceUnavailable: Service unavailable error ,
Timeout: Timeout error ,
QuotaExceeded: Quota exceeded error ,
Conflict: Conflict error ,
Warning: Warning error ,
}
,
Required: True ,
}
enum ,
message:
{
Description: A human-readable representation of the error. ,
Required: True ,
}
string ,
target:
{
Description: The target of the error. ,
Required: False ,
}
string ,
details:
{
Description: An array of details about specific errors that led to this reported error. ,
Required: False ,
}
[
string ,
]
,
innererror:
{
Description: An object containing more specific information than the current object about the error. ,
Required: False ,
}
{
code:
{
Description: One of a server-defined set of error codes. ,
Enum:
{
InvalidRequest: Invalid request error ,
InvalidParameterValue: Invalid parameter value error ,
KnowledgeBaseNotFound: Knowledge base not found error ,
AzureCognitiveSearchNotFound: Azure Cognitive Search not found error ,
AzureCognitiveSearchThrottling: Azure Cognitive Search throttling error ,
ExtractionFailure: Extraction failure error ,
InvalidRequestBodyFormat: Invalid request body format error ,
EmptyRequest: Empty request error ,
MissingInputDocuments: Missing input documents error ,
InvalidDocument: Invalid document error ,
ModelVersionIncorrect: Model version incorrect error ,
InvalidDocumentBatch: Invalid document batch error ,
UnsupportedLanguageCode: Unsupported language code error ,
InvalidCountryHint: Invalid country hint error ,
}
,
Required: True ,
}
enum ,
message:
{
Description: Error message. ,
Required: True ,
}
string ,
details:
{
Description: Error details. ,
Required: False ,
}
object ,
target:
{
Description: Error target. ,
Required: False ,
}
string ,
innererror:
{
Required: False ,
}
string ,
}
,
}
,
}
,
}
QuestionAnsweringProjects_UpdateSynonyms (updated)
Description :  Updates all the synonyms of a project.
Reference :  Link ¶

⚶ Changes

{
  "#id": "QuestionAnsweringProjects_UpdateSynonyms",
  "$parameters": [
    {
      "#name": "api-version",
      "Description": {
        "new": "The API version to use for this operation.",
        "old": "Client API version."
      }
    },
    {
      "body": {
        "Description": {
          "new": "Request payload for updating synonyms.",
          "old": "All synonym assets for this project."
        },
        "$properties": [
          {
            "#name": "value",
            "Description": {
              "new": "The WordAlterations items on this page",
              "old": "Collection of synonyms."
            },
            "Required": {
              "new": true,
              "old": false
            }
          }
        ]
      }
    }
  ],
  "$responses": {
    "default": {
      "$properties": {
        "error": [
          {
            "#name": "code",
            "Enum": {
              "new": [
                [
                  "InvalidRequest",
                  "Invalid request error"
                ],
                [
                  "InvalidArgument",
                  "Invalid argument error"
                ],
                [
                  "Unauthorized",
                  "Unauthorized access error"
                ],
                [
                  "Forbidden",
                  "Forbidden access error"
                ],
                [
                  "NotFound",
                  "Not found error"
                ],
                [
                  "ProjectNotFound",
                  "Project not found error"
                ],
                [
                  "OperationNotFound",
                  "Operation not found error"
                ],
                [
                  "AzureCognitiveSearchNotFound",
                  "Azure Cognitive Search not found error"
                ],
                [
                  "AzureCognitiveSearchIndexNotFound",
                  "Azure Cognitive Search index not found error"
                ],
                [
                  "TooManyRequests",
                  "Too many requests error"
                ],
                [
                  "AzureCognitiveSearchThrottling",
                  "Azure Cognitive Search throttling error"
                ],
                [
                  "AzureCognitiveSearchIndexLimitReached",
                  "Azure Cognitive Search index limit reached error"
                ],
                [
                  "InternalServerError",
                  "Internal server error"
                ],
                [
                  "ServiceUnavailable",
                  "Service unavailable error"
                ],
                [
                  "Timeout",
                  "Timeout error"
                ],
                [
                  "QuotaExceeded",
                  "Quota exceeded error"
                ],
                [
                  "Conflict",
                  "Conflict error"
                ],
                [
                  "Warning",
                  "Warning error"
                ]
              ],
              "old": [
                [
                  "InvalidRequest",
                  ""
                ],
                [
                  "InvalidArgument",
                  ""
                ],
                [
                  "Unauthorized",
                  ""
                ],
                [
                  "Forbidden",
                  ""
                ],
                [
                  "NotFound",
                  ""
                ],
                [
                  "ProjectNotFound",
                  ""
                ],
                [
                  "OperationNotFound",
                  ""
                ],
                [
                  "AzureCognitiveSearchNotFound",
                  ""
                ],
                [
                  "AzureCognitiveSearchIndexNotFound",
                  ""
                ],
                [
                  "TooManyRequests",
                  ""
                ],
                [
                  "AzureCognitiveSearchThrottling",
                  ""
                ],
                [
                  "AzureCognitiveSearchIndexLimitReached",
                  ""
                ],
                [
                  "InternalServerError",
                  ""
                ],
                [
                  "ServiceUnavailable",
                  ""
                ],
                [
                  "Timeout",
                  ""
                ],
                [
                  "QuotaExceeded",
                  ""
                ],
                [
                  "Conflict",
                  ""
                ],
                [
                  "Warning",
                  ""
                ]
              ]
            }
          },
          {
            "#name": "innererror",
            "Description": {
              "new": "An object containing more specific information than the current object about\nthe error.",
              "old": "An object containing more specific information than the current object about the error."
            },
            "$properties": [
              {
                "#name": "code",
                "Enum": {
                  "new": [
                    [
                      "InvalidRequest",
                      "Invalid request error"
                    ],
                    [
                      "InvalidParameterValue",
                      "Invalid parameter value error"
                    ],
                    [
                      "KnowledgeBaseNotFound",
                      "Knowledge base not found error"
                    ],
                    [
                      "AzureCognitiveSearchNotFound",
                      "Azure Cognitive Search not found error"
                    ],
                    [
                      "AzureCognitiveSearchThrottling",
                      "Azure Cognitive Search throttling error"
                    ],
                    [
                      "ExtractionFailure",
                      "Extraction failure error"
                    ],
                    [
                      "InvalidRequestBodyFormat",
                      "Invalid request body format error"
                    ],
                    [
                      "EmptyRequest",
                      "Empty request error"
                    ],
                    [
                      "MissingInputDocuments",
                      "Missing input documents error"
                    ],
                    [
                      "InvalidDocument",
                      "Invalid document error"
                    ],
                    [
                      "ModelVersionIncorrect",
                      "Model version incorrect error"
                    ],
                    [
                      "InvalidDocumentBatch",
                      "Invalid document batch error"
                    ],
                    [
                      "UnsupportedLanguageCode",
                      "Unsupported language code error"
                    ],
                    [
                      "InvalidCountryHint",
                      "Invalid country hint error"
                    ]
                  ],
                  "old": [
                    [
                      "InvalidRequest",
                      ""
                    ],
                    [
                      "InvalidParameterValue",
                      ""
                    ],
                    [
                      "KnowledgeBaseNotFound",
                      ""
                    ],
                    [
                      "AzureCognitiveSearchNotFound",
                      ""
                    ],
                    [
                      "AzureCognitiveSearchThrottling",
                      ""
                    ],
                    [
                      "ExtractionFailure",
                      ""
                    ],
                    [
                      "InvalidRequestBodyFormat",
                      ""
                    ],
                    [
                      "EmptyRequest",
                      ""
                    ],
                    [
                      "MissingInputDocuments",
                      ""
                    ],
                    [
                      "InvalidDocument",
                      ""
                    ],
                    [
                      "ModelVersionIncorrect",
                      ""
                    ],
                    [
                      "InvalidDocumentBatch",
                      ""
                    ],
                    [
                      "UnsupportedLanguageCode",
                      ""
                    ],
                    [
                      "InvalidCountryHint",
                      ""
                    ]
                  ]
                }
              }
            ]
          }
        ]
      }
    }
  }
}

⚼ Request

PUT:  /authoring/query-knowledgebases/projects/{projectName}/synonyms
{
api-version:
{
Description: The API version to use for this operation. ,
Required: True ,
}
string ,
projectName:
{
Description: The name of the project to use. ,
Required: True ,
}
string ,
body:
{
Description: All the synonyms of a project. ,
Required: True ,
}
{
value:
{
Description: The WordAlterations items on this page ,
Required: True ,
}
[
{
alterations:
{
Description: Collection of word alterations. ,
Required: True ,
}
[
string ,
]
,
}
,
]
,
nextLink:
{
Description: The link to the next page of items ,
Format: uri ,
Required: False ,
}
string ,
}
,
}

⚐ Response (204)

{}

⚐ Response (default)

{
$headers:
{
x-ms-error-code:
{
Description: String error code indicating what went wrong. ,
}
string ,
}
,
$schema:
{
Description: Error response. ,
}
{
error:
{
Description: The error object. ,
Required: True ,
}
{
code:
{
Description: One of a server-defined set of error codes. ,
Enum:
{
InvalidRequest: Invalid request error ,
InvalidArgument: Invalid argument error ,
Unauthorized: Unauthorized access error ,
Forbidden: Forbidden access error ,
NotFound: Not found error ,
ProjectNotFound: Project not found error ,
OperationNotFound: Operation not found error ,
AzureCognitiveSearchNotFound: Azure Cognitive Search not found error ,
AzureCognitiveSearchIndexNotFound: Azure Cognitive Search index not found error ,
TooManyRequests: Too many requests error ,
AzureCognitiveSearchThrottling: Azure Cognitive Search throttling error ,
AzureCognitiveSearchIndexLimitReached: Azure Cognitive Search index limit reached error ,
InternalServerError: Internal server error ,
ServiceUnavailable: Service unavailable error ,
Timeout: Timeout error ,
QuotaExceeded: Quota exceeded error ,
Conflict: Conflict error ,
Warning: Warning error ,
}
,
Required: True ,
}
enum ,
message:
{
Description: A human-readable representation of the error. ,
Required: True ,
}
string ,
target:
{
Description: The target of the error. ,
Required: False ,
}
string ,
details:
{
Description: An array of details about specific errors that led to this reported error. ,
Required: False ,
}
[
string ,
]
,
innererror:
{
Description: An object containing more specific information than the current object about the error. ,
Required: False ,
}
{
code:
{
Description: One of a server-defined set of error codes. ,
Enum:
{
InvalidRequest: Invalid request error ,
InvalidParameterValue: Invalid parameter value error ,
KnowledgeBaseNotFound: Knowledge base not found error ,
AzureCognitiveSearchNotFound: Azure Cognitive Search not found error ,
AzureCognitiveSearchThrottling: Azure Cognitive Search throttling error ,
ExtractionFailure: Extraction failure error ,
InvalidRequestBodyFormat: Invalid request body format error ,
EmptyRequest: Empty request error ,
MissingInputDocuments: Missing input documents error ,
InvalidDocument: Invalid document error ,
ModelVersionIncorrect: Model version incorrect error ,
InvalidDocumentBatch: Invalid document batch error ,
UnsupportedLanguageCode: Unsupported language code error ,
InvalidCountryHint: Invalid country hint error ,
}
,
Required: True ,
}
enum ,
message:
{
Description: Error message. ,
Required: True ,
}
string ,
details:
{
Description: Error details. ,
Required: False ,
}
object ,
target:
{
Description: Error target. ,
Required: False ,
}
string ,
innererror:
{
Required: False ,
}
string ,
}
,
}
,
}
,
}
QuestionAnsweringProjects_GetDeleteStatus (updated)
Description :  Gets the status of a Project delete job.
Reference :  Link ¶

⚶ Changes

{
  "#id": "QuestionAnsweringProjects_GetDeleteStatus",
  "$parameters": [
    {
      "#name": "api-version",
      "Description": {
        "new": "The API version to use for this operation.",
        "old": "Client API version."
      }
    },
    {
      "#name": "jobId",
      "Description": {
        "new": "The job ID.",
        "old": "Job ID."
      }
    }
  ],
  "$responses": {
    "200": {
      "Description": {
        "new": "Represents the state of a project deletion job.",
        "old": "Job state represents the job metadata and any errors."
      },
      "Type": {
        "new": "object",
        "old": "string"
      }
    },
    "default": {
      "$properties": {
        "error": [
          {
            "#name": "code",
            "Enum": {
              "new": [
                [
                  "InvalidRequest",
                  "Invalid request error"
                ],
                [
                  "InvalidArgument",
                  "Invalid argument error"
                ],
                [
                  "Unauthorized",
                  "Unauthorized access error"
                ],
                [
                  "Forbidden",
                  "Forbidden access error"
                ],
                [
                  "NotFound",
                  "Not found error"
                ],
                [
                  "ProjectNotFound",
                  "Project not found error"
                ],
                [
                  "OperationNotFound",
                  "Operation not found error"
                ],
                [
                  "AzureCognitiveSearchNotFound",
                  "Azure Cognitive Search not found error"
                ],
                [
                  "AzureCognitiveSearchIndexNotFound",
                  "Azure Cognitive Search index not found error"
                ],
                [
                  "TooManyRequests",
                  "Too many requests error"
                ],
                [
                  "AzureCognitiveSearchThrottling",
                  "Azure Cognitive Search throttling error"
                ],
                [
                  "AzureCognitiveSearchIndexLimitReached",
                  "Azure Cognitive Search index limit reached error"
                ],
                [
                  "InternalServerError",
                  "Internal server error"
                ],
                [
                  "ServiceUnavailable",
                  "Service unavailable error"
                ],
                [
                  "Timeout",
                  "Timeout error"
                ],
                [
                  "QuotaExceeded",
                  "Quota exceeded error"
                ],
                [
                  "Conflict",
                  "Conflict error"
                ],
                [
                  "Warning",
                  "Warning error"
                ]
              ],
              "old": [
                [
                  "InvalidRequest",
                  ""
                ],
                [
                  "InvalidArgument",
                  ""
                ],
                [
                  "Unauthorized",
                  ""
                ],
                [
                  "Forbidden",
                  ""
                ],
                [
                  "NotFound",
                  ""
                ],
                [
                  "ProjectNotFound",
                  ""
                ],
                [
                  "OperationNotFound",
                  ""
                ],
                [
                  "AzureCognitiveSearchNotFound",
                  ""
                ],
                [
                  "AzureCognitiveSearchIndexNotFound",
                  ""
                ],
                [
                  "TooManyRequests",
                  ""
                ],
                [
                  "AzureCognitiveSearchThrottling",
                  ""
                ],
                [
                  "AzureCognitiveSearchIndexLimitReached",
                  ""
                ],
                [
                  "InternalServerError",
                  ""
                ],
                [
                  "ServiceUnavailable",
                  ""
                ],
                [
                  "Timeout",
                  ""
                ],
                [
                  "QuotaExceeded",
                  ""
                ],
                [
                  "Conflict",
                  ""
                ],
                [
                  "Warning",
                  ""
                ]
              ]
            }
          },
          {
            "#name": "innererror",
            "Description": {
              "new": "An object containing more specific information than the current object about\nthe error.",
              "old": "An object containing more specific information than the current object about the error."
            },
            "$properties": [
              {
                "#name": "code",
                "Enum": {
                  "new": [
                    [
                      "InvalidRequest",
                      "Invalid request error"
                    ],
                    [
                      "InvalidParameterValue",
                      "Invalid parameter value error"
                    ],
                    [
                      "KnowledgeBaseNotFound",
                      "Knowledge base not found error"
                    ],
                    [
                      "AzureCognitiveSearchNotFound",
                      "Azure Cognitive Search not found error"
                    ],
                    [
                      "AzureCognitiveSearchThrottling",
                      "Azure Cognitive Search throttling error"
                    ],
                    [
                      "ExtractionFailure",
                      "Extraction failure error"
                    ],
                    [
                      "InvalidRequestBodyFormat",
                      "Invalid request body format error"
                    ],
                    [
                      "EmptyRequest",
                      "Empty request error"
                    ],
                    [
                      "MissingInputDocuments",
                      "Missing input documents error"
                    ],
                    [
                      "InvalidDocument",
                      "Invalid document error"
                    ],
                    [
                      "ModelVersionIncorrect",
                      "Model version incorrect error"
                    ],
                    [
                      "InvalidDocumentBatch",
                      "Invalid document batch error"
                    ],
                    [
                      "UnsupportedLanguageCode",
                      "Unsupported language code error"
                    ],
                    [
                      "InvalidCountryHint",
                      "Invalid country hint error"
                    ]
                  ],
                  "old": [
                    [
                      "InvalidRequest",
                      ""
                    ],
                    [
                      "InvalidParameterValue",
                      ""
                    ],
                    [
                      "KnowledgeBaseNotFound",
                      ""
                    ],
                    [
                      "AzureCognitiveSearchNotFound",
                      ""
                    ],
                    [
                      "AzureCognitiveSearchThrottling",
                      ""
                    ],
                    [
                      "ExtractionFailure",
                      ""
                    ],
                    [
                      "InvalidRequestBodyFormat",
                      ""
                    ],
                    [
                      "EmptyRequest",
                      ""
                    ],
                    [
                      "MissingInputDocuments",
                      ""
                    ],
                    [
                      "InvalidDocument",
                      ""
                    ],
                    [
                      "ModelVersionIncorrect",
                      ""
                    ],
                    [
                      "InvalidDocumentBatch",
                      ""
                    ],
                    [
                      "UnsupportedLanguageCode",
                      ""
                    ],
                    [
                      "InvalidCountryHint",
                      ""
                    ]
                  ]
                }
              }
            ]
          }
        ]
      }
    }
  }
}

⚼ Request

GET:  /authoring/query-knowledgebases/projects/deletion-jobs/{jobId}
{
api-version:
{
Description: The API version to use for this operation. ,
Required: True ,
}
string ,
jobId:
{
Description: The job ID. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
createdDateTime:
{
Description: The creation date time of the job. ,
Format: date-time ,
Required: True ,
}
string ,
expirationDateTime:
{
Description: The expiration date time of the job. ,
Format: date-time ,
Required: False ,
}
string ,
jobId:
{
Description: The job ID. ,
Required: True ,
}
string ,
lastUpdatedDateTime:
{
Description: The last date time the job was updated. ,
Format: date-time ,
Required: True ,
}
string ,
status:
{
Description: Job Status. ,
Enum:
{
notStarted: No description available. ,
running: No description available. ,
succeeded: No description available. ,
failed: No description available. ,
cancelled: No description available. ,
cancelling: No description available. ,
partiallyCompleted: No description available. ,
}
,
Required: True ,
}
enum ,
errors:
{
Description: The errors encountered while executing the job. ,
Required: False ,
}
[
{
code:
{
Description: One of a server-defined set of error codes. ,
Required: True ,
}
string ,
message:
{
Description: A human-readable representation of the error. ,
Required: True ,
}
string ,
target:
{
Description: The target of the error. ,
Required: False ,
}
string ,
details:
{
Description: An array of details about specific errors that led to this reported error. ,
Required: False ,
}
[
string ,
]
,
innererror:
{
Description: An object containing more specific information than the current object about the error. ,
Required: False ,
}
{
code:
{
Description: One of a server-defined set of error codes. ,
Required: False ,
}
string ,
innererror:
{
Required: False ,
}
string ,
}
,
}
,
]
,
}

⚐ Response (default)

{
$headers:
{
x-ms-error-code:
{
Description: String error code indicating what went wrong. ,
}
string ,
}
,
$schema:
{
Description: Error response. ,
}
{
error:
{
Description: The error object. ,
Required: True ,
}
{
code:
{
Description: One of a server-defined set of error codes. ,
Enum:
{
InvalidRequest: Invalid request error ,
InvalidArgument: Invalid argument error ,
Unauthorized: Unauthorized access error ,
Forbidden: Forbidden access error ,
NotFound: Not found error ,
ProjectNotFound: Project not found error ,
OperationNotFound: Operation not found error ,
AzureCognitiveSearchNotFound: Azure Cognitive Search not found error ,
AzureCognitiveSearchIndexNotFound: Azure Cognitive Search index not found error ,
TooManyRequests: Too many requests error ,
AzureCognitiveSearchThrottling: Azure Cognitive Search throttling error ,
AzureCognitiveSearchIndexLimitReached: Azure Cognitive Search index limit reached error ,
InternalServerError: Internal server error ,
ServiceUnavailable: Service unavailable error ,
Timeout: Timeout error ,
QuotaExceeded: Quota exceeded error ,
Conflict: Conflict error ,
Warning: Warning error ,
}
,
Required: True ,
}
enum ,
message:
{
Description: A human-readable representation of the error. ,
Required: True ,
}
string ,
target:
{
Description: The target of the error. ,
Required: False ,
}
string ,
details:
{
Description: An array of details about specific errors that led to this reported error. ,
Required: False ,
}
[
string ,
]
,
innererror:
{
Description: An object containing more specific information than the current object about the error. ,
Required: False ,
}
{
code:
{
Description: One of a server-defined set of error codes. ,
Enum:
{
InvalidRequest: Invalid request error ,
InvalidParameterValue: Invalid parameter value error ,
KnowledgeBaseNotFound: Knowledge base not found error ,
AzureCognitiveSearchNotFound: Azure Cognitive Search not found error ,
AzureCognitiveSearchThrottling: Azure Cognitive Search throttling error ,
ExtractionFailure: Extraction failure error ,
InvalidRequestBodyFormat: Invalid request body format error ,
EmptyRequest: Empty request error ,
MissingInputDocuments: Missing input documents error ,
InvalidDocument: Invalid document error ,
ModelVersionIncorrect: Model version incorrect error ,
InvalidDocumentBatch: Invalid document batch error ,
UnsupportedLanguageCode: Unsupported language code error ,
InvalidCountryHint: Invalid country hint error ,
}
,
Required: True ,
}
enum ,
message:
{
Description: Error message. ,
Required: True ,
}
string ,
details:
{
Description: Error details. ,
Required: False ,
}
object ,
target:
{
Description: Error target. ,
Required: False ,
}
string ,
innererror:
{
Required: False ,
}
string ,
}
,
}
,
}
,
}