---
title: "Changes to Create Scan"
method: POST
path: "/v1/scans"
---

# Changes to Create Scan

`POST /v1/scans`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 11 of 24 revisions.

- **2026-10-02** `b81128edddb8`: 1 warning
- **2026-06-11** `220f0adf9efd`: 1 info
- **2026-03-06** `b69f036fb8ff`: 1 info
- **2025-11-18** `41ee26b930f3`: 4 info
- **2025-10-28** `c9df54e2fb2c`: 1 info
- **2025-08-13** `c41cd7ae7718`: 1 warning, 2 info
- **2024-09-22** `407b73d9ce28`: 3 info
- **2024-04-19** `ba8a20839440`: 9 breaking, 3 warning, 23 info
- **2024-01-31** `4f557b176ebd`: 2 breaking, 1 warning, 6 info
- **2023-12-06** `35be9c1301b7`: 1 info
- **2023-12-05** `5c3748c387f7`: 33 warning, 13 info

## Changes

- **2026-10-02** `b81128edddb8`: 1 warning
  - removed the request property `socks5_proxy`
- **2026-06-11** `220f0adf9efd`: 1 info
  - added the new optional request property `asset_filters/not_seen_for_days`
- **2026-03-06** `b69f036fb8ff`: 1 info
  - added the new optional request property `asset_filters`
- **2025-11-18** `41ee26b930f3`: 4 info
  - added the new optional request property `agent_behavior`
  - added the new optional request property `agent_id`
  - added the new optional request property `agent_networks`
  - added the new optional request property `agent_tags`
- **2025-10-28** `c9df54e2fb2c`: 1 info
  - added the new optional request property `exclusions`
- **2025-08-13** `c41cd7ae7718`: 1 warning, 2 info
  - removed the request property `enumeration_ids/items/type`
  - added the new optional request property `automatic_scan`
  - added the new optional request property `scan_all_assets`
- **2024-09-22** `407b73d9ce28`: 3 info
  - added the new optional `header` request parameter `X-Team-Id`
  - added the new optional request property `socks5_proxy`
  - added the optional property `truncated-scan-targets` to the response with the `200` status
- **2024-04-19** `ba8a20839440`: 9 breaking, 3 warning, 23 info
  - removed the media type `application/xml` for the response with the status `400`
  - removed the media type `application/xml` for the response with the status `401`
  - removed the media type `application/xml` for the response with the status `500`
  - removed the media type `multipart/form-data` for the response with the status `400`
  - removed the media type `multipart/form-data` for the response with the status `401`
  - removed the media type `multipart/form-data` for the response with the status `500`
  - removed the media type `text/html` for the response with the status `400`
  - removed the media type `text/html` for the response with the status `401`
  - removed the media type `text/html` for the response with the status `500`
  - removed the optional property `id` from the response with the `400` status
  - removed the optional property `id` from the response with the `401` status
  - removed the optional property `id` from the response with the `500` status
  - added the new optional request property `disable_global_alert_config`
  - added the new optional request property `disable_global_report_config`
  - added the new optional request property `disable_global_scan_config`
  - added the new optional request property `exclude_targets`
  - added the new optional request property `schedule_only`
  - added the optional property `code` to the response with the `400` status
  - added the optional property `code` to the response with the `401` status
  - added the optional property `code` to the response with the `500` status
  - added the optional property `error` to the response with the `400` status
  - added the optional property `error` to the response with the `401` status
  - added the optional property `error` to the response with the `500` status
  - added the optional property `error_id` to the response with the `400` status
  - added the optional property `error_id` to the response with the `401` status
  - added the optional property `error_id` to the response with the `500` status
  - added the optional property `kind` to the response with the `400` status
  - added the optional property `kind` to the response with the `401` status
  - added the optional property `kind` to the response with the `500` status
  - added the optional property `param` to the response with the `400` status
  - added the optional property `param` to the response with the `401` status
  - added the optional property `param` to the response with the `500` status
  - added the optional property `status` to the response with the `400` status
  - added the optional property `status` to the response with the `401` status
  - added the optional property `status` to the response with the `500` status
- **2024-01-31** `4f557b176ebd`: 2 breaking, 1 warning, 6 info
  - the request property `private_templates/items/contents` became required
  - the request property `private_templates/items/name` became required
  - removed the request property `scan_id`
  - added the new optional request property `alerting_config_ids`
  - added the new optional request property `early_templates`
  - added the new optional request property `enumeration_ids`
  - added the new optional request property `reporting_config_ids`
  - added the new optional request property `scan_config_ids`
  - added the non-success response with the status `400`
- **2023-12-06** `35be9c1301b7`: 1 info
  - api tag `scans` added
- **2023-12-05** `5c3748c387f7`: 33 warning, 13 info
  - deleted the `header` request parameter `X-Team-Id`
  - removed the request property `agent_behavior`
  - removed the request property `agent_id`
  - removed the request property `agent_networks`
  - removed the request property `agent_tags`
  - removed the request property `alerting_config_ids`
  - removed the request property `asset_filters`
  - removed the request property `automatic_scan`
  - removed the request property `disable_global_alert_config`
  - removed the request property `disable_global_report_config`
  - removed the request property `disable_global_scan_config`
  - removed the request property `early_templates`
  - removed the request property `enumeration_ids`
  - removed the request property `exclude_targets`
  - removed the request property `exclusions`
  - removed the request property `reporting_config_ids`
  - removed the request property `scan_all_assets`
  - removed the request property `scan_config_ids`
  - removed the request property `schedule_only`
  - removed the request property `socks5_proxy`
  - removed the optional property `code` from the response with the `401` status
  - removed the optional property `code` from the response with the `500` status
  - removed the optional property `error` from the response with the `401` status
  - removed the optional property `error` from the response with the `500` status
  - removed the optional property `error_id` from the response with the `401` status
  - removed the optional property `error_id` from the response with the `500` status
  - removed the optional property `kind` from the response with the `401` status
  - removed the optional property `kind` from the response with the `500` status
  - removed the optional property `param` from the response with the `401` status
  - removed the optional property `param` from the response with the `500` status
  - removed the optional property `status` from the response with the `401` status
  - removed the optional property `status` from the response with the `500` status
  - removed the optional property `truncated-scan-targets` from the response with the `200` status (media type: application/json)
  - api tag `scans` removed
  - added the new optional request property `scan_id`
  - the request property `private_templates/items/contents` became optional
  - the request property `private_templates/items/name` became optional
  - added the media type `application/xml` for the response with the status `401`
  - added the media type `application/xml` for the response with the status `500`
  - added the media type `multipart/form-data` for the response with the status `401`
  - …6 more

---

[Operation](https://skmtc.dev/projectdiscovery/apis/pdcp-api/docs/v1/scans/post.md) - [API](https://skmtc.dev/projectdiscovery/apis/pdcp-api.md) - [Page](https://skmtc.dev/projectdiscovery/apis/pdcp-api/changes/v1/scans/post)
