# Discovered Asset Ignore

POST /easm/discovery/assets/search:ignore: Ignores the discovered assets that match filters (ignored).

Source: https://docs.deepinfo.com/reference/easm/discovered-asset-ignore/

Last updated: 2026-09-27

---
`POST https://api.deepinfo.com/v1/easm/discovery/assets/search:ignore`

Ignores the discovered assets that match `filters` (`ignored`).

The action applies to **every record matching `filters`**. Always send a filter (for example by `id`); an empty filter matches all records.

> State changes are applied **asynchronously**: the new state is visible a few seconds after the response. The response body only reports how many records matched.

## Authentication

Send your API key in the `apikey` request header.

## Request Body

| Parameter | Type | Required | Description |
|---|---|---|---|
| `filters` | object | Optional | See [Filtering](#ref-filtering) below |
| `sort` | array | Optional | List of `{field, order}` |

```json
{
  "filters": {
    "must": [
      {
        "name": "asset",
        "type": "eq",
        "value": "acme.example"
      }
    ]
  }
}
```

## Filtering

Example body:

```json
{
  "filters": {
    "must": [
      {
        "name": "asset",
        "type": "eq",
        "value": "<value>"
      }
    ]
  },
  "sort": [
    {
      "field": "asset",
      "order": "desc"
    }
  ]
}
```

See [Getting Started → Search & Filters](/getting-started/search-and-filters/) for the operators.

The Request Template example holds this body with every filter of this endpoint, one entry per field, each with an operator the field accepts and a placeholder value. Copy it, keep the filters you need and set their values.

### Searchable Fields

Grouped by the operators they accept (measured against the API; sending another operator returns 400).

Operators: `eq`, `in`, `startswith`, `endswith`, `wildcard`, `fuzzy`, `contains_any`, `contains_all`, `exists`

| Field | Description |
|---|---|
| `asset` | The discovered asset's name: a domain, subdomain or IP address, or for a website asset `host:port`. |
| `discovery_history.id` | The ID of a discovery rule that found the asset, a 32-character hex string; the Discovery page's rule name filter sends this ID. |
| `discovery_history.seed_value` | The seed value a rule started from when it found the asset, such as an IP address, a certificate fingerprint, a phone number or an organization name. |
| `organization_name` | An organization name recorded for the discovered asset; in the samples it is set only on some domains and holds WHOIS-style values such as `redacted for privacy`. |

Operators: `eq`, `in`, `gte`, `lte`, `exists`

| Field | Description |
|---|---|
| `last_discovery_date` | When a rule last found the asset, shown as the discovery date in Discovery (UTC date-time). |
| `ignore_date` | When the asset was ignored in Discovery (UTC date-time); empty unless it is ignored. |
| `approve_date` | When the asset was approved into your inventory (UTC date-time); empty unless it is approved. |

Operators: `eq`, `in`, `exists`

| Field | Description |
|---|---|
| `asset_type` | The discovered asset's type: `domain`, `subdomain`, `ip` or `website`. |

### Sortable Fields

| Field | Description |
|---|---|
| `asset` | The discovered asset's name: a domain, subdomain or IP address, or for a website asset `host:port`. |
| `discovery_history` | The rule matches that found the asset, each with the rule ID, rule name, rule type (`smart_discovery`, `smart_monitoring` or `custom`), seed value and discovery date. |
| `last_discovery_date` | When a rule last found the asset, shown as the discovery date in Discovery (UTC date-time). |
| `organization_name` | An organization name recorded for the discovered asset; in the samples it is set only on some domains and holds WHOIS-style values such as `redacted for privacy`. |
| `ignore_date` | When the asset was ignored in Discovery (UTC date-time); empty unless it is ignored. |
| `approve_date` | When the asset was approved into your inventory (UTC date-time); empty unless it is approved. |

## Response Fields

| Field | Type |
|---|---|
| `discovered_asset_count` | integer |

## Response Schema

_Inferred from examples._ Built from the saved 2xx example response: the fields it contains, with the types seen there. It is not a contract.

| Field | Type |
|---|---|
| `discovered_asset_count` | number |

## Examples

### 200 · OK

```bash
curl -X POST 'https://api.deepinfo.com/v1/easm/discovery/assets/search:ignore' \
  -H 'apikey: YOUR_API_KEY' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
  "filters": {
    "must": [
      {
        "name": "asset",
        "type": "eq",
        "value": "acme.example"
      }
    ]
  }
}'
```

`Content-Type: application/json` · `deepinfo-request-id: 00000000-0000-4000-8000-0000356d0001`

```json
{
  "discovered_asset_count": 1
}
```

### 400 · Malformed JSON

```bash
curl -X POST 'https://api.deepinfo.com/v1/easm/discovery/assets/search:ignore' \
  -H 'apikey: YOUR_API_KEY' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{"filters": '
```

`Content-Type: application/json` · `deepinfo-request-id: 00000000-0000-4000-8000-0000356d0001`

```json
{
  "code": 10400,
  "details": [
    "Invalid JSON data."
  ],
  "solution": "https://docs.deepinfo.com/reference/"
}
```

### Request Template

The request only: a request template has no response.

```bash
curl -X POST 'https://api.deepinfo.com/v1/easm/discovery/assets/search:ignore' \
  -H 'apikey: YOUR_API_KEY' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
  "filters": {
    "must": [
      {
        "name": "asset",
        "type": "eq",
        "value": "<value>"
      },
      {
        "name": "discovery_history.id",
        "type": "eq",
        "value": "<value>"
      },
      {
        "name": "discovery_history.seed_value",
        "type": "eq",
        "value": "<value>"
      },
      {
        "name": "organization_name",
        "type": "eq",
        "value": "<value>"
      },
      {
        "name": "last_discovery_date",
        "type": "eq",
        "value": "<date-time>"
      },
      {
        "name": "ignore_date",
        "type": "eq",
        "value": "<date-time>"
      },
      {
        "name": "approve_date",
        "type": "eq",
        "value": "<date-time>"
      },
      {
        "name": "asset_type",
        "type": "eq",
        "value": "<value>"
      }
    ]
  },
  "sort": [
    {
      "field": "asset",
      "order": "desc"
    }
  ]
}'
```