openapi-directory/api/azure.com/cognitiveservices-LUIS-Programmatic.json

Building & bundling https://github.com/APIs-guru/openapi-directory for easy use from JS

{"openapi":"3.0.0","info":{"title":"LUIS Programmatic","version":"v2.0","x-apisguru-categories":["cloud"],"x-logo":{"url":"https://assets.onestore.ms/cdnfiles/onestorerolling-1606-01000/shell/v3/images/logo/microsoft.png"},"x-origin":[{"format":"swagger","url":"https://raw.githubusercontent.com/Azure/azure-rest-api-specs/master/specification/cognitiveservices/data-plane/LUIS/Programmatic/stable/v2.0/LUIS-Programmatic.json","version":"2.0"}],"x-providerName":"azure.com","x-serviceName":"cognitiveservices-LUIS-Programmatic","x-tags":["Azure","Microsoft"]},"security":[{"apiKeyHeader":[]}],"paths":{"/apps/":{"get":{"description":"Lists all of the user applications.","operationId":"Apps_List","parameters":[{"$ref":"#/components/parameters/SkipInPath"},{"$ref":"#/components/parameters/TakeInPath"}],"responses":{"200":{"description":"A list of the user applications.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApplicationsInfoList"},"examples":{"Successful Get Applications List request":{"$ref":"#/components/examples/Successful_Get_Applications_List_request"}}}}},"default":{"description":"Error Response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"description":"Creates a new LUIS app.","operationId":"Apps_Add","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApplicationCreateObject"}}},"description":"A model containing Name, Description (optional), Culture, Usage Scenario (optional), Domain (optional) and initial version ID (optional) of the application. Default value for the version ID is 0.1. Note: the culture cannot be changed after the app is created.","required":true},"responses":{"201":{"description":"The ID of the created application.","x-nullable":false,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GuidResponse"},"examples":{"Successful Application Creation":{"$ref":"#/components/examples/Successful_Application_Creation"}}}}},"default":{"description":"Error Response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/apps/assistants":{"get":{"description":"Gets the endpoint URLs for the prebuilt Cortana applications.","operationId":"Apps_ListCortanaEndpoints","responses":{"200":{"description":"A personal assistant apps JSON object containing the endpoint URLs for Cortana applications and the user's endpoint keys.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PersonalAssistantsResponse"},"examples":{"Successful Get Personal Assistant Applications":{"$ref":"#/components/examples/Successful_Get_Personal_Assistant_Applications"}}}}},"default":{"description":"Error Response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/apps/cultures":{"get":{"description":"Gets the supported application cultures.","operationId":"Apps_ListSupportedCultures","responses":{"200":{"description":"A list object containing the supported application cultures.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AvailableCultures"},"examples":{"Successful Get Application Cultures request":{"$ref":"#/components/examples/Successful_Get_Application_Cultures_request"}}}}},"default":{"description":"Error Response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/apps/customprebuiltdomains":{"get":{"description":"Gets all the available custom prebuilt domains for all cultures.","operationId":"Apps_ListAvailableCustomPrebuiltDomains","responses":{"200":{"description":"Returns a list of all custom prebuilt domains and their intents/entities representation.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PrebuiltDomainsList"},"examples":{"Successful Get Available Custom Prebuilt Domains request":{"$ref":"#/components/examples/Successful_Get_Available_Custom_Prebuilt_Domains_request"}}}}},"default":{"description":"Error Response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"description":"Adds a prebuilt domain along with its models as a new application.","operationId":"Apps_AddCustomPrebuiltDomain","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PrebuiltDomainCreateObject"}}},"description":"A prebuilt domain create object containing the name and culture of the domain.","required":true},"responses":{"201":{"description":"The ID of the created application.","x-nullable":false,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GuidResponse"},"examples":{"Successful Add Custom Prebuilt Application request":{"$ref":"#/components/examples/Successful_Add_Custom_Prebuilt_Application_request"}}}}},"default":{"description":"Error Response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/apps/customprebuiltdomains/{culture}":{"get":{"description":"Gets all the available custom prebuilt domains for a specific culture.","operationId":"Apps_ListAvailableCustomPrebuiltDomainsForCulture","parameters":[{"description":"Culture.","in":"path","name":"culture","required":true,"schema":{"type":"string"},"examples":{"Successful Get AvailableCustomPrebuiltDomainsForCulture request":{"value":"{culture}"}}}],"responses":{"200":{"description":"Returns a list of all domains and their intents/entities representation for a specific culture.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PrebuiltDomainsList"},"examples":{"Successful Get AvailableCustomPrebuiltDomainsForCulture request":{"$ref":"#/components/examples/Successful_Get_AvailableCustomPrebuiltDomainsForCulture_request"}}}}},"default":{"description":"Error Response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/apps/domains":{"get":{"description":"Gets the available application domains.","operationId":"Apps_ListDomains","responses":{"200":{"description":"A list object containing the available application domains.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AvailableDomains"},"examples":{"Successful Get Application Domains request":{"$ref":"#/components/examples/Successful_Get_Application_Domains_request"}}}}},"default":{"description":"Error Response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/apps/import":{"post":{"description":"Imports an application to LUIS, the application's structure should be included in in the request body.","operationId":"Apps_Import","parameters":[{"description":"The application name to create. If not specified, the application name will be read from the imported object.","in":"query","name":"appName","schema":{"type":"string"},"examples":{"Successful Import Application":{"value":"Test LUIS App"}}}],"requestBody":{"$ref":"#/components/requestBodies/LuisApp"},"responses":{"201":{"description":"The ID of the imported application.","x-nullable":false,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GuidResponse"},"examples":{"Successful Import Application":{"$ref":"#/components/examples/Successful_Import_Application"}}}}},"default":{"description":"Error Response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/apps/usagescenarios":{"get":{"description":"Gets the application available usage scenarios.","operationId":"Apps_ListUsageScenarios","responses":{"200":{"description":"A list object containing the available application usage scenarios.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApplicationUsageScenarios"},"examples":{"Successful Get Application Usage Scenarios request":{"$ref":"#/components/examples/Successful_Get_Application_Usage_Scenarios_request"}}}}},"default":{"description":"Error Response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/apps/{appId}":{"delete":{"description":"Deletes an application.","operationId":"Apps_Delete","parameters":[{"$ref":"#/components/parameters/AppIdInPath"}],"responses":{"200":{"description":"Successfully deleted application.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OperationStatus"},"examples":{"Successful Rename Application request":{"$ref":"#/components/examples/Successful_Rename_Application_request"}}}}},"default":{"description":"Error Response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"get":{"description":"Gets the application info.","operationId":"Apps_Get","parameters":[{"$ref":"#/components/parameters/AppIdInPath"}],"responses":{"200":{"description":"The application info.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApplicationInfoResponse"},"examples":{"Successful Get Application Info request":{"$ref":"#/components/examples/Successful_Get_Application_Info_request"}}}}},"default":{"description":"Error Response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"put":{"description":"Updates the name or description of the application.","operationId":"Apps_Update","parameters":[{"$ref":"#/components/parameters/AppIdInPath"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApplicationUpdateObject"}}},"description":"A model containing Name and Description of the application.","required":true},"responses":{"200":{"description":"Successfully updated application name and description.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OperationStatus"},"examples":{"Successful Rename Application request":{"$ref":"#/components/examples/Successful_Rename_Application_request"}}}}},"default":{"description":"Error Response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/apps/{appId}/endpoints":{"get":{"description":"Returns the available endpoint deployment regions and URLs.","operationId":"Apps_ListEndpoints","parameters":[{"$ref":"#/components/parameters/AppIdInPath"}],"responses":{"200":{"description":"Returns a list of endpoints regions and their corresponding endpoint URL.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AvailableEndpoints"},"examples":{"Successful Get Endpoints request":{"$ref":"#/components/examples/Successful_Get_Endpoints_request"}}}}},"default":{"description":"Error Response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/apps/{appId}/permissions":{"delete":{"description":"Removes a user from the allowed list of users to access this LUIS application. Users are removed using their email address.","operationId":"Permissions_Delete","parameters":[{"$ref":"#/components/parameters/AppIdInPath"}],"requestBody":{"$ref":"#/components/requestBodies/UserCollaborator"},"responses":{"200":{"description":"Successful operation.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OperationStatus"},"examples":{"Successful Remove User From Access List":{"$ref":"#/components/examples/Successful_Remove_User_From_Access_List"}}}}},"default":{"description":"Error Response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"get":{"description":"Gets the list of user emails that have permissions to access your application.","operationId":"Permissions_List","parameters":[{"$ref":"#/components/parameters/AppIdInPath"}],"responses":{"200":{"description":"The list includes a single owner. All collaborators are listed in the emails array.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UserAccessList"},"examples":{"Successful Get Application User Access List":{"$ref":"#/components/examples/Successful_Get_Application_User_Access_List"}}}}},"default":{"description":"Error Response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"description":"Adds a user to the allowed list of users to access this LUIS application. Users are added using their email address.","operationId":"Permissions_Add","parameters":[{"$ref":"#/components/parameters/AppIdInPath"}],"requestBody":{"$ref":"#/components/requestBodies/UserCollaborator"},"responses":{"200":{"description":"Successful operation.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OperationStatus"},"examples":{"Successful Add User To Access List":{"$ref":"#/components/examples/Successful_Add_User_To_Access_List"}}}}},"default":{"description":"Error Response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"put":{"description":"Replaces the current users access list with the one sent in the body. If an empty list is sent, all access to other users will be removed.","operationId":"Permissions_Update","parameters":[{"$ref":"#/components/parameters/AppIdInPath"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CollaboratorsArray"}}},"description":"A model containing a list of user's email addresses.","required":true},"responses":{"200":{"description":"Successful operation.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OperationStatus"},"examples":{"Successful Replaces Users From Access List":{"$ref":"#/components/examples/Successful_Replaces_Users_From_Access_List"}}}}},"default":{"description":"Error Response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/apps/{appId}/publish":{"post":{"description":"Publishes a specific version of the application.","operationId":"Apps_Publish","parameters":[{"$ref":"#/components/parameters/AppIdInPath"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApplicationPublishObject"}}},"description":"The application publish object. The region is the target region that the application is published to.","required":true},"responses":{"201":{"description":"An object containing the application endpoint URL and its assigned endpoint key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProductionOrStagingEndpointInfo"},"examples":{"Successful Publish Application request":{"$ref":"#/components/examples/Successful_Publish_Application_request"}}}}},"default":{"description":"Error Response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/apps/{appId}/querylogs":{"get":{"description":"Gets the query logs of the past month for the application.","operationId":"Apps_DownloadQueryLogs","parameters":[{"$ref":"#/components/parameters/AppIdInPath"}],"responses":{"200":{"description":"A CSV file containing the query logs for the past month.","content":{"application/octet-stream":{"schema":{"description":"The query logs of an application for the past month in CSV format.","format":"file","type":"object"},"examples":{"Successful Download Application Query logs request":{"$ref":"#/components/examples/Successful_Download_Application_Query_logs_request"}}}}},"default":{"description":"Error Response.","content":{"application/octet-stream":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/apps/{appId}/settings":{"get":{"description":"Get the application settings.","operationId":"Apps_GetSettings","parameters":[{"$ref":"#/components/parameters/AppIdInPath"}],"responses":{"200":{"description":"The application settings.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApplicationSettings"},"examples":{"Successful Get Application Settings request":{"$ref":"#/components/examples/Successful_Get_Application_Settings_request"}}}}},"default":{"description":"Error Response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"put":{"description":"Updates the application settings.","operationId":"Apps_UpdateSettings","parameters":[{"$ref":"#/components/parameters/AppIdInPath"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApplicationSettingUpdateObject"}}},"description":"An object containing the new application settings.","required":true},"responses":{"200":{"description":"Successfully updated application settings.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OperationStatus"},"examples":{"Successful Update Application Settings request":{"$ref":"#/components/examples/Successful_Update_Application_Settings_request"}}}}},"default":{"description":"Error Response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/apps/{appId}/versions":{"get":{"description":"Gets the application versions info.","operationId":"Versions_List","parameters":[{"$ref":"#/components/parameters/AppIdInPath"},{"$ref":"#/components/parameters/SkipInPath"},{"$ref":"#/components/parameters/TakeInPath"}],"responses":{"200":{"description":"A list of all versions of the application.","content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/VersionInfo"},"type":"array"},"examples":{"Successful Get Application Versions info request":{"$ref":"#/components/examples/Successful_Get_Application_Versions_info_request"}}}}},"default":{"description":"Error Response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/apps/{appId}/versions/import":{"post":{"description":"Imports a new version into a LUIS application.","operationId":"Versions_Import","parameters":[{"$ref":"#/components/parameters/AppIdInPath"},{"description":"The new versionId to import. If not specified, the versionId will be read from the imported object.","in":"query","name":"versionId","schema":{"type":"string"},"examples":{"Successful Import Application":{"value":"0.2"}}}],"requestBody":{"$ref":"#/components/requestBodies/LuisApp"},"responses":{"201":{"description":"The created application version.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/VersionResponse"},"examples":{"Successful Import Application":{"$ref":"#/components/examples/Successful_Import_Application"}}}}},"default":{"description":"Error Response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/apps/{appId}/versions/{versionId}/":{"delete":{"description":"Deletes an application version.","operationId":"Versions_Delete","parameters":[{"$ref":"#/components/parameters/AppIdInPath"},{"$ref":"#/components/parameters/VersionIdInPath"}],"responses":{"200":{"description":"Successful operation.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OperationStatus"},"examples":{"Successful Delete Application Version request":{"$ref":"#/components/examples/Successful_Delete_Application_Version_request"}}}}},"default":{"description":"Error Response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"get":{"description":"Gets the version info.","operationId":"Versions_Get","parameters":[{"$ref":"#/components/parameters/AppIdInPath"},{"$ref":"#/components/parameters/VersionIdInPath"}],"responses":{"200":{"description":"A model containing the version info.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/VersionInfo"},"examples":{"Successful Get Application Version info request":{"$ref":"#/components/examples/Successful_Get_Application_Version_info_request"}}}}},"default":{"description":"Error Response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"put":{"description":"Updates the name or description of the application version.","operationId":"Versions_Update","parameters":[{"$ref":"#/components/parameters/AppIdInPath"},{"$ref":"#/components/parameters/VersionIdInPath"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TaskUpdateObject"}}},"description":"A model containing Name and Description of the application.","required":true},"responses":{"200":{"description":"Successful operation.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OperationStatus"},"examples":{"Successful Rename Application Version request":{"$ref":"#/components/examples/Successful_Rename_Application_Version_request"}}}}},"default":{"description":"Error Response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/apps/{appId}/versions/{versionId}/clone":{"post":{"description":"Creates a new version using the current snapshot of the selected application version.","operationId":"Versions_Clone","parameters":[{"$ref":"#/components/parameters/AppIdInPath"},{"$ref":"#/components/parameters/VersionIdInPath"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TaskUpdateObject"}}},"description":"A model containing the new version ID."},"responses":{"201":{"description":"The version ID of the created task.","content":{"application/json":{"schema":{"example":"0.2","type":"string"},"examples":{"Successful Clone Application Version request":{"$ref":"#/components/examples/Successful_Clone_Application_Version_request"}}}}},"default":{"description":"Error Response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/apps/{appId}/versions/{versionId}/closedlists":{"get":{"description":"Gets information about the closedlist models.","operationId":"Model_ListClosedLists","parameters":[{"$ref":"#/components/parameters/AppIdInPath"},{"$ref":"#/components/parameters/VersionIdInPath"},{"$ref":"#/components/parameters/SkipInPath"},{"$ref":"#/components/parameters/TakeInPath"}],"responses":{"200":{"description":"A list of closedlist entity model infos.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ClosedListEntityExtractorsList"},"examples":{"Successful Get Application Version Closed List Infos request":{"$ref":"#/components/examples/Successful_Get_Application_Version_Closed_List_Infos_request"}}}}},"default":{"description":"Error Response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"description":"Adds a closed list model to the application.","operationId":"Model_AddClosedList","parameters":[{"$ref":"#/components/parameters/AppIdInPath"},{"$ref":"#/components/parameters/VersionIdInPath"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ClosedListModelCreateObject"}}},"description":"A model containing the name and words for the new closed list entity extractor.","required":true},"responses":{"201":{"description":"The ID of the created model.","x-nullable":false,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GuidResponse"},"examples":{"Successful Create Closed List Entity Model request":{"$ref":"#/components/examples/Successful_Create_Closed_List_Entity_Model_request"}}}}},"default":{"description":"Error Response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/apps/{appId}/versions/{versionId}/closedlists/{clEntityId}":{"delete":{"description":"Deletes a closed list model from the application.","operationId":"Model_DeleteClosedList","parameters":[{"$ref":"#/components/parameters/AppIdInPath"},{"$ref":"#/components/parameters/VersionIdInPath"},{"description":"The closed list model ID.","in":"path","name":"clEntityId","required":true,"schema":{"type":"string","format":"uuid"},"examples":{"Successful Delete Closed List Entity Info request":{"value":"d1f95436-57ac-4524-ae81-5bdd32668ccf"}}}],"responses":{"200":{"description":"Successfully delete Closed List from application.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OperationStatus"},"examples":{"Successful Delete Closed List Entity Info request":{"$ref":"#/components/examples/Successful_Delete_Closed_List_Entity_Info_request"}}}}},"default":{"description":"Error Response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"get":{"description":"Gets information of a closed list model.","operationId":"Model_GetClosedList","parameters":[{"$ref":"#/components/parameters/AppIdInPath"},{"$ref":"#/components/parameters/VersionIdInPath"},{"description":"The closed list model ID.","in":"path","name":"clEntityId","required":true,"schema":{"type":"string","format":"uuid"},"examples":{"Successful Get Closed List Entity Info request":{"value":"8713b104-78ec-4c4f-9f96-f2e53562cc16"}}}],"responses":{"200":{"description":"The closed list model info.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ClosedListEntityExtractor"},"examples":{"Successful Get Closed List Entity Info request":{"$ref":"#/components/examples/Successful_Get_Closed_List_Entity_Info_request"}}}}},"default":{"description":"Error Response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"patch":{"description":"Adds a batch of sublists to an existing closedlist.","operationId":"Model_PatchClosedList","parameters":[{"$ref":"#/components/parameters/AppIdInPath"},{"$ref":"#/components/parameters/VersionIdInPath"},{"description":"The closed list model ID.","in":"path","name":"clEntityId","required":true,"schema":{"type":"string","format":"uuid"},"examples":{"Successful Add SubLists to Closed List Entity request":{"value":"d1f95436-57ac-4524-ae81-5bdd32668ccf"}}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ClosedListModelPatchObject"}}},"description":"A words list batch.","required":true},"responses":{"200":{"description":"Successfully added sublists to Closed List.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OperationStatus"},"examples":{"Successful Add SubLists to Closed List Entity request":{"$ref":"#/components/examples/Successful_Add_SubLists_to_Closed_List_Entity_request"}}}}},"default":{"description":"Error Response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"put":{"description":"Updates the closed list model.","operationId":"Model_UpdateClosedList","parameters":[{"$ref":"#/components/parameters/AppIdInPath"},{"$ref":"#/components/parameters/VersionIdInPath"},{"description":"The closed list model ID.","in":"path","name":"clEntityId","required":true,"schema":{"type":"string","format":"uuid"},"examples":{"Successful Update Closed List Entity Info request":{"value":"d1f95436-57ac-4524-ae81-5bdd32668ccf"}}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ClosedListModelUpdateObject"}}},"description":"The new entity name and words list.","required":true},"responses":{"200":{"description":"Successfully updated Closed List name and words list.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OperationStatus"},"examples":{"Successful Update Closed List Entity Info request":{"$ref":"#/components/examples/Successful_Update_Closed_List_Entity_Info_request"}}}}},"default":{"description":"Error Response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/apps/{appId}/versions/{versionId}/closedlists/{clEntityId}/sublists":{"post":{"description":"Adds a list to an existing closed list.","operationId":"Model_AddSubList","parameters":[{"$ref":"#/components/parameters/AppIdInPath"},{"$ref":"#/components/parameters/VersionIdInPath"},{"description":"The closed list entity extractor ID.","in":"path","name":"clEntityId","required":true,"schema":{"type":"string","format":"uuid"},"examples":{"Successful Add Sublist request":{"value":"d1f95436-57ac-4524-ae81-5bdd32668ccf"}}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WordListObject"}}},"description":"Words list.","required":true},"responses":{"201":{"description":"The ID of the newly created list.","content":{"application/json":{"schema":{"example":90440,"type":"integer"},"examples":{"Successful Add Sublist request":{"$ref":"#/components/examples/Successful_Add_Sublist_request"}}}}},"default":{"description":"Error Response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/apps/{appId}/versions/{versionId}/closedlists/{clEntityId}/sublists/{subListId}":{"delete":{"description":"Deletes a sublist of a specific closed list model.","operationId":"Model_DeleteSubList","parameters":[{"$ref":"#/components/parameters/AppIdInPath"},{"$ref":"#/components/parameters/VersionIdInPath"},{"description":"The closed list entity extractor ID.","in":"path","name":"clEntityId","required":true,"schema":{"type":"string","format":"uuid"},"examples":{"Successful Delete Sublist request":{"value":"d1f95436-57ac-4524-ae81-5bdd32668ccf"}}},{"description":"The sublist ID.","in":"path","name":"subListId","required":true,"schema":{"type":"integer"},"examples":{"Successful Delete Sublist request":{"value":123}}}],"responses":{"200":{"description":"Successfully deleted sublist.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OperationStatus"},"examples":{"Successful Delete Sublist request":{"$ref":"#/components/examples/Successful_Delete_Sublist_request"}}}}},"default":{"description":"Error Response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"put":{"description":"Updates one of the closed list's sublists.","operationId":"Model_UpdateSubList","parameters":[{"$ref":"#/components/parameters/AppIdInPath"},{"$ref":"#/components/parameters/VersionIdInPath"},{"description":"The closed list entity extractor ID.","in":"path","name":"clEntityId","required":true,"schema":{"type":"string","format":"uuid"},"examples":{"Successful Update Sublist request":{"value":"d1f95436-57ac-4524-ae81-5bdd32668ccf"}}},{"description":"The sublist ID.","in":"path","name":"subListId","required":true,"schema":{"type":"integer"},"examples":{"Successful Update Sublist request":{"value":123}}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WordListBaseUpdateObject"}}},"description":"A sublist update object containing the new canonical form and the list of words.","required":true},"responses":{"200":{"description":"Successfully updated sublist.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OperationStatus"},"examples":{"Successful Update Sublist request":{"$ref":"#/components/examples/Successful_Update_Sublist_request"}}}}},"default":{"description":"Error Response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/apps/{appId}/versions/{versionId}/compositeentities":{"get":{"description":"Gets information about the composite entity models.","operationId":"Model_ListCompositeEntities","parameters":[{"$ref":"#/components/parameters/AppIdInPath"},{"$ref":"#/components/parameters/VersionIdInPath"},{"$ref":"#/components/parameters/SkipInPath"},{"$ref":"#/components/parameters/TakeInPath"}],"responses":{"200":{"description":"A list of composite entity model infos.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CompositeEntityExtractorsList"},"examples":{"Successful Get Application Version Composite Entity Infos request":{"$ref":"#/components/examples/Successful_Get_Application_Version_Composite_Entity_Infos_request"}}}}},"default":{"description":"Error Response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"description":"Adds a composite entity extractor to the application.","operationId":"Model_AddCompositeEntity","parameters":[{"$ref":"#/components/parameters/AppIdInPath"},{"$ref":"#/components/parameters/VersionIdInPath"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CompositeEntityModel"}}},"description":"A model containing the name and children of the new entity extractor.","required":true},"responses":{"201":{"description":"The ID of the created Model.","x-nullable":false,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GuidResponse"},"examples":{"Successful Create Composite Entity Extractor":{"$ref":"#/components/examples/Successful_Create_Composite_Entity_Extractor"}}}}},"default":{"description":"Error Response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/apps/{appId}/versions/{versionId}/compositeentities/{cEntityId}":{"delete":{"description":"Deletes a composite entity extractor from the application.","operationId":"Model_DeleteCompositeEntity","parameters":[{"$ref":"#/components/parameters/AppIdInPath"},{"$ref":"#/components/parameters/VersionIdInPath"},{"$ref":"#/components/parameters/CEntityIdInPath"}],"responses":{"200":{"description":"Successfully deleted composite entity.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OperationStatus"},"examples":{"Successful Delete Entity Info request":{"$ref":"#/components/examples/Successful_Delete_Entity_Info_request"}}}}},"default":{"description":"Error Response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"get":{"description":"Gets information about the composite entity model.","operationId":"Model_GetCompositeEntity","parameters":[{"$ref":"#/components/parameters/AppIdInPath"},{"$ref":"#/components/parameters/VersionIdInPath"},{"$ref":"#/components/parameters/CEntityIdInPath"}],"responses":{"200":{"description":"The composite entity model info.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CompositeEntityExtractor"},"examples":{"Successful Get Composite Entity Info request":{"$ref":"#/components/examples/Successful_Get_Composite_Entity_Info_request"}}}}},"default":{"description":"Error Response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"put":{"description":"Updates the composite entity extractor.","operationId":"Model_UpdateCompositeEntity","parameters":[{"$ref":"#/components/parameters/AppIdInPath"},{"$ref":"#/components/parameters/VersionIdInPath"},{"$ref":"#/components/parameters/CEntityIdInPath"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CompositeEntityModel"}}},"description":"A model object containing the new entity extractor name and children.","required":true},"responses":{"200":{"description":"Successfully updated composite entity.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OperationStatus"},"examples":{"Successful Update Composite Entity Extractor request":{"$ref":"#/components/examples/Successful_Update_Composite_Entity_Extractor_request"}}}}},"default":{"description":"Error Response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/apps/{appId}/versions/{versionId}/compositeentities/{cEntityId}/children":{"post":{"description":"Creates a single child in an existing composite entity model.","operationId":"Model_AddCompositeEntityChild","parameters":[{"$ref":"#/components/parameters/AppIdInPath"},{"$ref":"#/components/parameters/VersionIdInPath"},{"$ref":"#/components/parameters/CEntityIdInPath"}],"requestBody":{"content":{"application/json":{"schema":{"properties":{"name":{"type":"string"}},"type":"object"}}},"description":"A model object containing the name of the new composite child model.","required":true},"responses":{"201":{"description":"The ID of the created model.","x-nullable":false,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GuidResponse"},"examples":{"Successful Create Composite Entity Child Model request":{"$ref":"#/components/examples/Successful_Create_Composite_Entity_Child_Model_request"}}}}},"default":{"description":"Error Response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/apps/{appId}/versions/{versionId}/compositeentities/{cEntityId}/children/{cChildId}":{"delete":{"description":"Deletes a composite entity extractor child from the application.","operationId":"Model_DeleteCompositeEntityChild","parameters":[{"$ref":"#/components/parameters/AppIdInPath"},{"$ref":"#/components/parameters/VersionIdInPath"},{"$ref":"#/components/parameters/CEntityIdInPath"},{"description":"The hierarchical entity extractor child ID.","in":"path","name":"cChildId","required":true,"schema":{"type":"string","format":"uuid"},"examples":{"Successful Delete Composite Entity Child Model request":{"value":"891c235f-4f42-4320-bc36-b6256b6c3f2b"}}}],"responses":{"200":{"description":"Successfully deleted entity.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OperationStatus"},"examples":{"Successful Delete Composite Entity Child Model request":{"$ref":"#/components/examples/Successful_Delete_Composite_Entity_Child_Model_request"}}}}},"default":{"description":"Error Response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/apps/{appId}/versions/{versionId}/customprebuiltdomains":{"post":{"description":"Adds a customizable prebuilt domain along with all of its models to this application.","operationId":"Model_AddCustomPrebuiltDomain","parameters":[{"$ref":"#/components/parameters/AppIdInPath"},{"$ref":"#/components/parameters/VersionIdInPath"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PrebuiltDomainCreateBaseObject"}}},"description":"A prebuilt domain create object containing the name of the domain.","required":true},"responses":{"201":{"description":"An array of the created custom prebuilt domain model Ids.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GuidList"},"examples":{"Successful Add Custom Prebuilt Domain to Application request":{"$ref":"#/components/examples/Successful_Add_Custom_Prebuilt_Domain_to_Application_request"}}}}},"default":{"description":"Error Response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/apps/{appId}/versions/{versionId}/customprebuiltdomains/{domainName}":{"delete":{"description":"Deletes a prebuilt domain's models from the application.","operationId":"Model_DeleteCustomPrebuiltDomain","parameters":[{"$ref":"#/components/parameters/AppIdInPath"},{"$ref":"#/components/parameters/VersionIdInPath"},{"description":"Domain name.","in":"path","name":"domainName","required":true,"schema":{"type":"string"},"examples":{"Successful Delete Prebuilt Domain from Application request":{"value":"Web"}}}],"responses":{"200":{"description":"Successful operation.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OperationStatus"},"examples":{"Successful Delete Prebuilt Domain from Application request":{"$ref":"#/components/examples/Successful_Delete_Prebuilt_Domain_from_Application_request"}}}}},"default":{"description":"Error Response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/apps/{appId}/versions/{versionId}/customprebuiltentities":{"get":{"description":"Gets all custom prebuilt entities information of this application.","operationId":"Model_ListCustomPrebuiltEntities","parameters":[{"$ref":"#/components/parameters/AppIdInPath"},{"$ref":"#/components/parameters/VersionIdInPath"}],"responses":{"200":{"description":"Returns a list of all custom prebuilt entities and their representations.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/EntityExtractorsList"},"examples":{"Successful Get Custom Prebuilt Domain Entities request":{"$ref":"#/components/examples/Successful_Get_Custom_Prebuilt_Domain_Entities_request"}}}}},"default":{"description":"Error Response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"description":"Adds a custom prebuilt entity model to the application.","operationId":"Model_AddCustomPrebuiltEntity","parameters":[{"$ref":"#/components/parameters/AppIdInPath"},{"$ref":"#/components/parameters/VersionIdInPath"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PrebuiltDomainModelCreateObject"}}},"description":"A model object containing the name of the custom prebuilt entity and the name of the domain to which this model belongs.","required":true},"responses":{"201":{"description":"The ID of the created model.","x-nullable":false,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GuidResponse"},"examples":{"Successful Add Custom Prebuilt Entity request":{"$ref":"#/components/examples/Successful_Add_Custom_Prebuilt_Entity_request"}}}}},"default":{"description":"Error Response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/apps/{appId}/versions/{versionId}/customprebuiltintents":{"get":{"description":"Gets custom prebuilt intents information of this application.","operationId":"Model_ListCustomPrebuiltIntents","parameters":[{"$ref":"#/components/parameters/AppIdInPath"},{"$ref":"#/components/parameters/VersionIdInPath"}],"responses":{"200":{"description":"Returns a list of all custom prebuilt intents and their representations.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/IntentClassifiersList"},"examples":{"Successful Get Custom Prebuilt Intent request":{"$ref":"#/components/examples/Successful_Get_Custom_Prebuilt_Intent_request"}}}}},"default":{"description":"Error Response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"description":"Adds a custom prebuilt intent model to the application.","operationId":"Model_AddCustomPrebuiltIntent","parameters":[{"$ref":"#/components/parameters/AppIdInPath"},{"$ref":"#/components/parameters/VersionIdInPath"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PrebuiltDomainModelCreateObject"}}},"description":"A model object containing the name of the custom prebuilt intent and the name of the domain to which this model belongs.","required":true},"responses":{"201":{"description":"The ID of the created model.","x-nullable":false,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GuidResponse"},"examples":{"Successful Add Custom Prebuilt Intent request":{"$ref":"#/components/examples/Successful_Add_Custom_Prebuilt_Intent_request"}}}}},"default":{"description":"Error Response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/apps/{appId}/versions/{versionId}/customprebuiltmodels":{"get":{"description":"Gets all custom prebuilt models information of this application.","operationId":"Model_ListCustomPrebuiltModels","parameters":[{"$ref":"#/components/parameters/AppIdInPath"},{"$ref":"#/components/parameters/VersionIdInPath"}],"responses":{"200":{"description":"Returns a list of all custom prebuilt models and their representations.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CustomPrebuiltModelList"},"examples":{"Successful Get Custom Prebuilt Domain Models request":{"$ref":"#/components/examples/Successful_Get_Custom_Prebuilt_Domain_Models_request"}}}}},"default":{"description":"Error Response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/apps/{appId}/versions/{versionId}/entities":{"get":{"description":"Gets information about the entity models.","operationId":"Model_ListEntities","parameters":[{"$ref":"#/components/parameters/AppIdInPath"},{"$ref":"#/components/parameters/VersionIdInPath"},{"$ref":"#/components/parameters/SkipInPath"},{"$ref":"#/components/parameters/TakeInPath"}],"responses":{"200":{"description":"A list of entity model infos.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/EntityExtractorsList"},"examples":{"Successful Get Application Version Entity Infos request":{"$ref":"#/components/examples/Successful_Get_Application_Version_Entity_Infos_request"}}}}},"default":{"description":"Error Response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"description":"Adds an entity extractor to the application.","operationId":"Model_AddEntity","parameters":[{"$ref":"#/components/parameters/AppIdInPath"},{"$ref":"#/components/parameters/VersionIdInPath"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ModelCreateObject"}}},"description":"A model object containing the name for the new entity extractor.","required":true},"responses":{"201":{"description":"The ID of the created model.","x-nullable":false,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GuidResponse"},"examples":{"Successful Create Entity Extractor request":{"$ref":"#/components/examples/Successful_Create_Entity_Extractor_request"}}}}},"default":{"description":"Error Response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/apps/{appId}/versions/{versionId}/entities/{entityId}":{"delete":{"description":"Deletes an entity extractor from the application.","operationId":"Model_DeleteEntity","parameters":[{"$ref":"#/components/parameters/AppIdInPath"},{"$ref":"#/components/parameters/VersionIdInPath"},{"description":"The entity extractor ID.","in":"path","name":"entityId","required":true,"schema":{"type":"string","format":"uuid"},"examples":{"Successful Delete Entity Info request":{"value":"3d73462d-98f0-4dcd-8d30-fab9e65f2e73"}}}],"responses":{"200":{"description":"Successfully deleted entity.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OperationStatus"},"examples":{"Successful Delete Entity Info request":{"$ref":"#/components/examples/Successful_Delete_Entity_Info_request"}}}}},"default":{"description":"Error Response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"get":{"description":"Gets information about the entity model.","operationId":"Model_GetEntity","parameters":[{"$ref":"#/components/parameters/AppIdInPath"},{"$ref":"#/components/parameters/VersionIdInPath"},{"description":"The entity extractor ID.","in":"path","name":"entityId","required":true,"schema":{"type":"string","format":"uuid"},"examples":{"Successful Get Entity Info request":{"value":"3d73462d-98f0-4dcd-8d30-fab9e65f2e73"}}}],"responses":{"200":{"description":"An entity model info.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/EntityExtractor"},"examples":{"Successful Get Entity Info request":{"$ref":"#/components/examples/Successful_Get_Entity_Info_request"}}}}},"default":{"description":"Error Response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"put":{"description":"Updates the name of an entity extractor.","operationId":"Model_UpdateEntity","parameters":[{"$ref":"#/components/parameters/AppIdInPath"},{"$ref":"#/components/parameters/VersionIdInPath"},{"description":"The entity extractor ID.","in":"path","name":"entityId","required":true,"schema":{"type":"string","format":"uuid"},"examples":{"Successful Rename Entity Info request":{"value":"3d73462d-98f0-4dcd-8d30-fab9e65f2e73"}}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ModelUpdateObject"}}},"description":"A model object containing the new entity extractor name.","required":true},"responses":{"200":{"description":"Successfully updated entity extractor name.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OperationStatus"},"examples":{"Successful Rename Entity Info request":{"$ref":"#/components/examples/Successful_Rename_Entity_Info_request"}}}}},"default":{"description":"Error Response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/apps/{appId}/versions/{versionId}/entities/{entityId}/suggest":{"get":{"description":"Get suggestion examples that would improve the accuracy of the entity model.","operationId":"Model_GetEntitySuggestions","parameters":[{"$ref":"#/components/parameters/AppIdInPath"},{"$ref":"#/components/parameters/VersionIdInPath"},{"description":"The target entity extractor model to enhance.","in":"path","name":"entityId","required":true,"schema":{"type":"string","format":"uuid"},"examples":{"Successful Get Entity Suggestion Examples":{"value":"3d73462d-98f0-4dcd-8d30-fab9e65f2e73"}}},{"$ref":"#/components/parameters/TakeInPath"}],"responses":{"200":{"description":"If there's no trained model, nothing is returned in the response. If there's a trained model and the active learning algorithm finds any relevant queries, they are returned with the model predictions. If there's a trained model but the active learning algorithm didn't find any relevant queries, an empty list is returned in the response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/EntitiesSuggestionExamples"},"examples":{"Successful Get Entity Suggestion Examples":{"$ref":"#/components/examples/Successful_Get_Entity_Suggestion_Examples"}}}}},"default":{"description":"Error Response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/apps/{appId}/versions/{versionId}/example":{"post":{"description":"Adds a labeled example to the application.","operationId":"Examples_Add","parameters":[{"$ref":"#/components/parameters/AppIdInPath"},{"$ref":"#/components/parameters/VersionIdInPath"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExampleLabelObject"}}},"description":"An example label with the expected intent and entities.","required":true},"responses":{"201":{"description":"The ID of the created example.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/LabelExampleResponse"},"examples":{"Successful Add Label request":{"$ref":"#/components/examples/Successful_Add_Label_request"}}}}},