---
title: "Create Enumeration"
method: POST
path: "/v1/asset/enumerate"
tags: ["enumerations"]
---

# Create Enumeration

`POST /v1/asset/enumerate`

Create a new enumeration

## Headers

- `X-Team-Id` string

## Request body

- object
  - `root_domains` string[]
  - `enrichment_inputs` string[]
  - `cloudlist_config_ids` string[]
  - `name` string
  - `steps` string[]
  - `enumeration_ports` string
  - `alerting_config_ids` string[]
  - `disable_global_alert_config` boolean
  - `exclude_targets` string[]
  - `enumeration_config` object
    - `follow-redirect` boolean
    - `ports` string
  - `automatic_vuln_scans` boolean
  - `per_domain_enumeration` boolean
  - `agent_id` string
  - `agent_tags` string[]
  - `agent_networks` string[]
  - `agent_behavior` 'distribute' | 'mirror'
  - `agent_auto_discover` boolean
  - `exclusions` string[] — Combined inclusion and exclusion patterns for discovery scope. Exclusion patterns (e.g. `*.staging.company.com`) filter out matching targets. Inclusion patterns use a `+` prefix (e.g. `+prod-*.company.com`) to restrict discovery to only matching targets (allowlist mode). When inclusion patterns are present, targets must match at least one inclusion pattern and not match any exclusion pattern. Supports exact domains, wildcard patterns, IP addresses, and CIDR ranges.

## Response `200`

OK

- object
  - `id` string
  - `truncated-scan-targets` integer
  - `is-public` boolean
  - `bulk_ids` string[]
  - `failed_domains` object — Map of domain to failure reason

## Other responses

- `400` — Example response
- `401` — Example response
- `403` — Example response
- `500` — Example response
- `default` — Example response

## Changes

- **2025-11-18** `41ee26b930f3` — 5 info
  - added the new optional request property `agent_auto_discover`
  - added the new optional request property `agent_behavior`
  - added the new optional request property `agent_id`
  - added the new optional request property `agent_networks`
  - …1 more
- **2025-10-28** `c9df54e2fb2c` — 1 info
  - added the new optional request property `exclusions`
- **2025-08-13** `c41cd7ae7718` — 1 breaking, 9 info
  - the response property `id` became optional for the status `200`
  - added the new optional request property `automatic_vuln_scans`
  - added the new optional request property `per_domain_enumeration`
  - added the new `dns_scraping` enum value to the request property `steps/items/`
  - …6 more
- **2024-09-22** `407b73d9ce28` — 1 breaking, 10 info
  - removed the enum value `endpoint_crawling` of the request property `steps/items/`
  - added the new optional `header` request parameter `X-Team-Id`
  - added the new optional request property `alerting_config_ids`
  - added the new optional request property `disable_global_alert_config`
  - …7 more
- **2024-04-19** `ba8a20839440` — 27 info
  - the endpoint scheme security `X-API-Key` was added to the API
  - api tag `enumerations` added
  - added the new optional request property `enumeration_ports`
  - added the optional property `code` to the response with the `400` status
  - …23 more

[Full history](https://skmtc.dev/projectdiscovery/apis/pdcp-api/changes/v1/asset/enumerate/post.md)

---

[API](https://skmtc.dev/projectdiscovery/apis/pdcp-api.md) · [All operations](https://skmtc.dev/projectdiscovery/apis/pdcp-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/projectdiscovery/pdcp-api/revisions/220f0adf9efd/schema)