# Microsoft.Discovery.Workspace service API > Microsoft.Discovery.Workspace service API on Apizie: 29 endpoints (List Conversation resources, Creates a Conversation., Fetch a Conversation by name., Updates a Conversation., …) returned as clean JSON through one API key. Send your own provider key in the x-upstream-key header. Call it over REST at https://apizie.tech/v1/cloud:azure-discovery-microsoft-discovery-workspace/{endpoint} or from Claude, ChatGPT and Cursor through the Apizie MCP server. Free plan: 1,000 requests a month. - Project key: `cloud:azure-discovery-microsoft-discovery-workspace` - Category: Cloud - Status: byok - Source: https://learn.microsoft.com/rest/api/azure/ - Page: https://apizie.tech/api/cloud/azure-discovery-microsoft-discovery-workspace - OpenAPI: https://apizie.tech/api/cloud/azure-discovery-microsoft-discovery-workspace/openapi.json ## Endpoints ### List Conversation resources `GET https://apizie.tech/v1/cloud:azure-discovery-microsoft-discovery-workspace/conversations-list` (byok) | Parameter | Type | Required | Description | |---|---|---|---| | endpoint | string | yes | Supported Discovery Workspace Services endpoints (protocol and hostname, for example: https://{workspaceName}.discovery.azure.com). | | api-version | string | no | The API version to use for this operation. | | investigationName | string | no | The name of the associated Investigation | | projectName | string | no | The name of the associated Project | | createdSince | string | no | The oldest creation timestamp to keep | | top | integer | no | The number of result items to return. | | skip | integer | no | The number of result items to skip. | | maxpagesize | integer | no | The maximum number of result items per page. | ### Creates a Conversation. `POST https://apizie.tech/v1/cloud:azure-discovery-microsoft-discovery-workspace/conversations-create` (byok) | Parameter | Type | Required | Description | |---|---|---|---| | endpoint | string | yes | Supported Discovery Workspace Services endpoints (protocol and hostname, for example: https://{workspaceName}.discovery.azure.com). | | api-version | string | no | The API version to use for this operation. | | body | object | yes | JSON request body | ### Fetch a Conversation by name. `GET https://apizie.tech/v1/cloud:azure-discovery-microsoft-discovery-workspace/conversations-get` (byok) | Parameter | Type | Required | Description | |---|---|---|---| | endpoint | string | yes | Supported Discovery Workspace Services endpoints (protocol and hostname, for example: https://{workspaceName}.discovery.azure.com). | | api-version | string | no | The API version to use for this operation. | | conversationName | string | yes | The conversation name. | ### Updates a Conversation. `POST https://apizie.tech/v1/cloud:azure-discovery-microsoft-discovery-workspace/conversations-update` (byok) | Parameter | Type | Required | Description | |---|---|---|---| | endpoint | string | yes | Supported Discovery Workspace Services endpoints (protocol and hostname, for example: https://{workspaceName}.discovery.azure.com). | | api-version | string | no | The API version to use for this operation. | | conversationName | string | yes | The conversation name. | | body | object | yes | JSON request body | ### Deletes a Conversation. `POST https://apizie.tech/v1/cloud:azure-discovery-microsoft-discovery-workspace/conversations-delete` (byok) | Parameter | Type | Required | Description | |---|---|---|---| | endpoint | string | yes | Supported Discovery Workspace Services endpoints (protocol and hostname, for example: https://{workspaceName}.discovery.azure.com). | | api-version | string | no | The API version to use for this operation. | | conversationName | string | yes | The conversation name. | ### List Investigation resources `GET https://apizie.tech/v1/cloud:azure-discovery-microsoft-discovery-workspace/investigations-list` (byok) | Parameter | Type | Required | Description | |---|---|---|---| | endpoint | string | yes | Supported Discovery Workspace Services endpoints (protocol and hostname, for example: https://{workspaceName}.discovery.azure.com). | | api-version | string | no | The API version to use for this operation. | | projectName | string | yes | The project name. | | createdSince | string | no | The oldest creation timestamp to keep | | top | integer | no | The number of result items to return. | | skip | integer | no | The number of result items to skip. | | maxpagesize | integer | no | The maximum number of result items per page. | ### Fetch a Investigation by name. `GET https://apizie.tech/v1/cloud:azure-discovery-microsoft-discovery-workspace/investigations-get` (byok) | Parameter | Type | Required | Description | |---|---|---|---| | endpoint | string | yes | Supported Discovery Workspace Services endpoints (protocol and hostname, for example: https://{workspaceName}.discovery.azure.com). | | api-version | string | no | The API version to use for this operation. | | projectName | string | yes | The project name. | | investigationName | string | yes | The investigation name. | ### Creates an Investigation. `POST https://apizie.tech/v1/cloud:azure-discovery-microsoft-discovery-workspace/investigations-create-or-replace` (byok) | Parameter | Type | Required | Description | |---|---|---|---| | endpoint | string | yes | Supported Discovery Workspace Services endpoints (protocol and hostname, for example: https://{workspaceName}.discovery.azure.com). | | api-version | string | no | The API version to use for this operation. | | projectName | string | yes | The project name. | | investigationName | string | yes | The investigation name. | | body | object | yes | JSON request body | ### Updates an Investigation. `POST https://apizie.tech/v1/cloud:azure-discovery-microsoft-discovery-workspace/investigations-update` (byok) | Parameter | Type | Required | Description | |---|---|---|---| | endpoint | string | yes | Supported Discovery Workspace Services endpoints (protocol and hostname, for example: https://{workspaceName}.discovery.azure.com). | | api-version | string | no | The API version to use for this operation. | | projectName | string | yes | The project name. | | investigationName | string | yes | The investigation name. | | body | object | yes | JSON request body | ### Delete a Investigation. `POST https://apizie.tech/v1/cloud:azure-discovery-microsoft-discovery-workspace/investigations-delete` (byok) | Parameter | Type | Required | Description | |---|---|---|---| | endpoint | string | yes | Supported Discovery Workspace Services endpoints (protocol and hostname, for example: https://{workspaceName}.discovery.azure.com). | | api-version | string | no | The API version to use for this operation. | | projectName | string | yes | The project name. | | investigationName | string | yes | The investigation name. | ### Get the discovery engine for an investigation. `GET https://apizie.tech/v1/cloud:azure-discovery-microsoft-discovery-workspace/investigations-get-discovery-engine` (byok) | Parameter | Type | Required | Description | |---|---|---|---| | endpoint | string | yes | Supported Discovery Workspace Services endpoints (protocol and hostname, for example: https://{workspaceName}.discovery.azure.com). | | api-version | string | no | The API version to use for this operation. | | projectName | string | yes | The project name. | | investigationName | string | yes | The investigation name. | ### Update the discovery engine for an investigation. This will create the discovery engine if it does not… `POST https://apizie.tech/v1/cloud:azure-discovery-microsoft-discovery-workspace/investigations-update-discovery-engine` (byok) | Parameter | Type | Required | Description | |---|---|---|---| | endpoint | string | yes | Supported Discovery Workspace Services endpoints (protocol and hostname, for example: https://{workspaceName}.discovery.azure.com). | | api-version | string | no | The API version to use for this operation. | | projectName | string | yes | The project name. | | investigationName | string | yes | The investigation name. | | body | object | yes | JSON request body | ### List discovery engine working memory entries for an investigation. `GET https://apizie.tech/v1/cloud:azure-discovery-microsoft-discovery-workspace/investigations-get-discovery-engine-memory` (byok) | Parameter | Type | Required | Description | |---|---|---|---| | endpoint | string | yes | Supported Discovery Workspace Services endpoints (protocol and hostname, for example: https://{workspaceName}.discovery.azure.com). | | api-version | string | no | The API version to use for this operation. | | projectName | string | yes | The project name. | | investigationName | string | yes | The investigation name. | | top | integer | no | The number of result items to return. | | skip | integer | no | The number of result items to skip. | | maxpagesize | integer | no | The maximum number of result items per page. | ### Start the discovery engine for an investigation. `POST https://apizie.tech/v1/cloud:azure-discovery-microsoft-discovery-workspace/investigations-start-discovery-engine` (byok) | Parameter | Type | Required | Description | |---|---|---|---| | endpoint | string | yes | Supported Discovery Workspace Services endpoints (protocol and hostname, for example: https://{workspaceName}.discovery.azure.com). | | api-version | string | no | The API version to use for this operation. | | projectName | string | yes | The project name. | | investigationName | string | yes | The investigation name. | ### Stop the discovery engine for an investigation. `POST https://apizie.tech/v1/cloud:azure-discovery-microsoft-discovery-workspace/investigations-stop-discovery-engine` (byok) | Parameter | Type | Required | Description | |---|---|---|---| | endpoint | string | yes | Supported Discovery Workspace Services endpoints (protocol and hostname, for example: https://{workspaceName}.discovery.azure.com). | | api-version | string | no | The API version to use for this operation. | | projectName | string | yes | The project name. | | investigationName | string | yes | The investigation name. | ### Get the status of a long-running operation. `GET https://apizie.tech/v1/cloud:azure-discovery-microsoft-discovery-workspace/investigations-get-operation-status` (byok) | Parameter | Type | Required | Description | |---|---|---|---| | endpoint | string | yes | Supported Discovery Workspace Services endpoints (protocol and hostname, for example: https://{workspaceName}.discovery.azure.com). | | api-version | string | no | The API version to use for this operation. | | projectName | string | yes | The project name. | | investigationName | string | yes | The investigation name. | | operationId | string | yes | The unique ID of the operation. | ### List tasks with optional OData filters. `GET https://apizie.tech/v1/cloud:azure-discovery-microsoft-discovery-workspace/tasks-list` (byok) | Parameter | Type | Required | Description | |---|---|---|---| | endpoint | string | yes | Supported Discovery Workspace Services endpoints (protocol and hostname, for example: https://{workspaceName}.discovery.azure.com). | | api-version | string | no | The API version to use for this operation. | | projectName | string | yes | The project name. | | investigationName | string | yes | The investigation name. | | filter | string | no | OData filter expression. Supported fields: investigationId, status, createdByType, priority, createdAt, lastModifiedAt. Example: status eq… | ### Create a new task. `POST https://apizie.tech/v1/cloud:azure-discovery-microsoft-discovery-workspace/tasks-create` (byok) | Parameter | Type | Required | Description | |---|---|---|---| | endpoint | string | yes | Supported Discovery Workspace Services endpoints (protocol and hostname, for example: https://{workspaceName}.discovery.azure.com). | | api-version | string | no | The API version to use for this operation. | | projectName | string | yes | The project name. | | investigationName | string | yes | The investigation name. | | body | object | yes | JSON request body | ### Get a task by ID. `GET https://apizie.tech/v1/cloud:azure-discovery-microsoft-discovery-workspace/tasks-get` (byok) | Parameter | Type | Required | Description | |---|---|---|---| | endpoint | string | yes | Supported Discovery Workspace Services endpoints (protocol and hostname, for example: https://{workspaceName}.discovery.azure.com). | | api-version | string | no | The API version to use for this operation. | | projectName | string | yes | The project name. | | investigationName | string | yes | The investigation name. | | taskName | string | yes | The unique identifier of the task. | ### Patch (partial update) a task (e.g. status, description, validation requirements, dependencies, result). `POST https://apizie.tech/v1/cloud:azure-discovery-microsoft-discovery-workspace/tasks-update` (byok) | Parameter | Type | Required | Description | |---|---|---|---| | endpoint | string | yes | Supported Discovery Workspace Services endpoints (protocol and hostname, for example: https://{workspaceName}.discovery.azure.com). | | api-version | string | no | The API version to use for this operation. | | projectName | string | yes | The project name. | | investigationName | string | yes | The investigation name. | | taskName | string | yes | The unique identifier of the task. | | body | object | yes | JSON request body | ### Delete a task by ID. `POST https://apizie.tech/v1/cloud:azure-discovery-microsoft-discovery-workspace/tasks-delete` (byok) | Parameter | Type | Required | Description | |---|---|---|---| | endpoint | string | yes | Supported Discovery Workspace Services endpoints (protocol and hostname, for example: https://{workspaceName}.discovery.azure.com). | | api-version | string | no | The API version to use for this operation. | | projectName | string | yes | The project name. | | investigationName | string | yes | The investigation name. | | taskName | string | yes | The unique identifier of the task. | ### Start execution of a task. `POST https://apizie.tech/v1/cloud:azure-discovery-microsoft-discovery-workspace/tasks-start` (byok) | Parameter | Type | Required | Description | |---|---|---|---| | endpoint | string | yes | Supported Discovery Workspace Services endpoints (protocol and hostname, for example: https://{workspaceName}.discovery.azure.com). | | api-version | string | no | The API version to use for this operation. | | projectName | string | yes | The project name. | | investigationName | string | yes | The investigation name. | | taskName | string | yes | The task name. | | body | object | no | JSON request body | ### Add a comment to a task. `POST https://apizie.tech/v1/cloud:azure-discovery-microsoft-discovery-workspace/tasks-add-comment` (byok) | Parameter | Type | Required | Description | |---|---|---|---| | endpoint | string | yes | Supported Discovery Workspace Services endpoints (protocol and hostname, for example: https://{workspaceName}.discovery.azure.com). | | api-version | string | no | The API version to use for this operation. | | projectName | string | yes | The project name. | | investigationName | string | yes | The investigation name. | | taskName | string | yes | The task name. | | body | object | yes | JSON request body | ### Add an execution history entry to a task. `POST https://apizie.tech/v1/cloud:azure-discovery-microsoft-discovery-workspace/tasks-add-execution-history` (byok) | Parameter | Type | Required | Description | |---|---|---|---| | endpoint | string | yes | Supported Discovery Workspace Services endpoints (protocol and hostname, for example: https://{workspaceName}.discovery.azure.com). | | api-version | string | no | The API version to use for this operation. | | projectName | string | yes | The project name. | | investigationName | string | yes | The investigation name. | | taskName | string | yes | The task name. | | body | object | yes | JSON request body | ### Run the specified tool in the context of the specified project. `POST https://apizie.tech/v1/cloud:azure-discovery-microsoft-discovery-workspace/tools-run` (byok) | Parameter | Type | Required | Description | |---|---|---|---| | endpoint | string | yes | Supported Discovery Workspace Services endpoints (protocol and hostname, for example: https://{workspaceName}.discovery.azure.com). | | api-version | string | no | The API version to use for this operation. | | projectName | string | yes | Name of the associated Project. | | body | object | yes | JSON request body | ### Examine compute usage. `GET https://apizie.tech/v1/cloud:azure-discovery-microsoft-discovery-workspace/tools-get-compute-usage` (byok) | Parameter | Type | Required | Description | |---|---|---|---| | endpoint | string | yes | Supported Discovery Workspace Services endpoints (protocol and hostname, for example: https://{workspaceName}.discovery.azure.com). | | api-version | string | no | The API version to use for this operation. | | projectName | string | yes | Name of the associated Project. | ### List tool runs. `GET https://apizie.tech/v1/cloud:azure-discovery-microsoft-discovery-workspace/tools-get-operations` (byok) | Parameter | Type | Required | Description | |---|---|---|---| | endpoint | string | yes | Supported Discovery Workspace Services endpoints (protocol and hostname, for example: https://{workspaceName}.discovery.azure.com). | | api-version | string | no | The API version to use for this operation. | | projectName | string | yes | Name of the associated Project. | | top | integer | no | The number of result items to return. | | skip | integer | no | The number of result items to skip. | | maxpagesize | integer | no | The maximum number of result items per page. | ### Used for to poll status of a Tool run. `GET https://apizie.tech/v1/cloud:azure-discovery-microsoft-discovery-workspace/tools-get-run-status` (byok) | Parameter | Type | Required | Description | |---|---|---|---| | endpoint | string | yes | Supported Discovery Workspace Services endpoints (protocol and hostname, for example: https://{workspaceName}.discovery.azure.com). | | api-version | string | no | The API version to use for this operation. | | projectName | string | yes | Name of the associated Project. | | logCount | integer | no | Number of log lines to return (0-2500). | | operationId | string | yes | The unique ID of the operation. | ### Cancel an ongoing tool run. `POST https://apizie.tech/v1/cloud:azure-discovery-microsoft-discovery-workspace/tools-cancel-run-lro` (byok) | Parameter | Type | Required | Description | |---|---|---|---| | endpoint | string | yes | Supported Discovery Workspace Services endpoints (protocol and hostname, for example: https://{workspaceName}.discovery.azure.com). | | api-version | string | no | The API version to use for this operation. | | projectName | string | yes | Name of the associated Project. | | operationId | string | yes | ID of the operation to cancel. | ## Example ``` curl "https://apizie.tech/v1/cloud:azure-discovery-microsoft-discovery-workspace/conversations-list" \ -H "x-api-key: $APIZIE_KEY" \ -H "x-upstream-key: $PROVIDER_KEY" ``` ## FAQ ### How do I call the Microsoft.Discovery.Workspace service API? Create a free Apizie key, then send GET https://apizie.tech/v1/cloud:azure-discovery-microsoft-discovery-workspace/conversations-list with the header x-api-key. Every endpoint returns { project, data, timestamp }. ### Is the Microsoft.Discovery.Workspace service API free on Apizie? Yes. The Free plan includes 1,000 requests a month at 100 requests a minute, no credit card. Microsoft.Discovery.Workspace service itself also needs your own key from azure.com. ### Can AI agents use the Microsoft.Discovery.Workspace service API? Yes. Add the Apizie MCP server (https://apizie.tech/mcp) to Claude, ChatGPT, Cursor or VS Code, then ask in plain language. The agent calls run_scraper with project key cloud:azure-discovery-microsoft-discovery-workspace. ### What is the status of the Microsoft.Discovery.Workspace service API? Needs your own provider key (bring your own key)