---
title: "POST /discoGroups:validate"
method: POST
path: "/discoGroups:validate"
tags: ["Discovery Groups"]
---

# POST /discoGroups:validate

`POST /discoGroups:validate`

Validate a discovery group with a given groupName.

## Query parameters

- `api-version` string, required

## Request body

- DiscoGroupData — A request body used to create a discovery group.
  - `name` string — The name for a disco group.
  - `description` string — The description for a disco group.
  - `tier` string — The tier for the disco group which will affect the algorithm used for the disco runs in this group.
  - `frequencyMilliseconds` integer — The frequency at which the disco group is supposed to be rerun in milliseconds.
  - `seeds` DiscoSource[] — The list of seeds used for the disco group runs.
    - `kind` 'as' | 'attribute' | 'contact' | 'domain' | 'host' | 'ipBlock' — The kind of disco source.
    - `name` string — The name for the disco source.
  - `names` string[] — The list of names used for the disco group runs.
  - `excludes` DiscoSource[] — The list of excludes used for the disco group runs, aka assets to exclude from the discovery algorithm.
    - `kind` 'as' | 'attribute' | 'contact' | 'domain' | 'host' | 'ipBlock' — The kind of disco source.
    - `name` string — The name for the disco source.
  - `templateId` string — The unique identifier for the disco template used for the disco group creation.

## Response `200`

The request has succeeded.

- ValidateResult — Validate result for validate action endpoints
  - `error` ErrorDetail — This is the top-level error object whose code matches the x-ms-error-code response header.
    - `code` string, required — This is one of a server-defined set of error codes.
    - `message` string, required — This is a human-readable representation of the error.
    - `target` string — This is the error target.
    - `details` ErrorDetail[] — This is an array of details about specific errors that led to this reported error.
    - `innererror` InnerError — This is an object containing more specific information than the current object about the error.
      - `code` string — This is a more specific error code than was provided by the containing error.
      - `value` unknown

## Other responses

- `default` — An unexpected error response.

---

[API](https://skmtc.net/azure/apis/riskiq-microsoft-easm.md) · [All operations](https://skmtc.net/azure/apis/riskiq-microsoft-easm/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/azure/riskiq-microsoft-easm/revisions/5865b52c51a3/schema)