---
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

## 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-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
- **2024-01-31** `4f557b176ebd` — 1 info
  - endpoint added
- **2023-12-05** `5c3748c387f7` — 1 breaking
  - api path removed without deprecation

[Change 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.dev/projectdiscovery/apis/pdcp-api/revisions/c41cd7ae7718?raw)