---
title: "Discover"
method: POST
path: "/v2/discovery"
tags: ["Discovery"]
---

# Discover

`POST /v2/discovery`

Start network discovery using the provided discovery request configuration. The discovery results are published to the configured default event transport.

## Request body

- DiscoveryRequestModel — Discovery request
  - `id` string — Id of discovery request
  - `discovery` 'Off' | 'Local' | 'Network' | 'Fast' | 'Scan' — Discovery mode to use
  - `configuration` DiscoveryConfigModel — Discovery configuration api model
    - `addressRangesToScan` string — Address ranges to scan (null == all wired nics)
    - `networkProbeTimeout` string, date-span — Network probe timeout
    - `maxNetworkProbes` integer — Max network probes that should ever run.
    - `portRangesToScan` string — Port ranges to scan (null == all unassigned)
    - `portProbeTimeout` string, date-span — Port probe timeout
    - `maxPortProbes` integer — Max port probes that should ever run.
    - `minPortProbesPercent` integer — Probes that must always be there as percent of max.
    - `idleTimeBetweenScans` string, date-span — Delay time between discovery sweeps
    - `discoveryUrls` string[] — List of preset discovery urls to use
    - `locales` string[] — List of locales to filter with during discovery
  - `context` OperationContextModel — Operation log model
    - `AuthorityId` string — User
    - `Time` string, date-time — Operation time

## Response `200`

The operation was successful or the response payload contains relevant error information.

- boolean

## Other responses

- `400` — The passed in information is invalid
- `408` — The operation timed out.
- `500` — An unexpected error occurred

---

[API](https://skmtc.net/azure/apis/opcpublisher.md) · [All operations](https://skmtc.net/azure/apis/opcpublisher/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/azure/opcpublisher/revisions/8eac19a554d6/schema)