---
title: "Create Retest Scan"
method: POST
path: "/v1/retest"
tags: ["retest"]
---

# Create Retest Scan

`POST /v1/retest`

Trigger a retest scan

## Request body

- object
  - `template_encoded` string
  - `target` string, required
  - `template_path` string
  - `template_url` string
  - `template_id` string
  - `vuln_id` string, required

## Response `200`

Example response

- object
  - `message` string, required
  - `results` VulnerabilityResults
    - `matcher_status` boolean, required
    - `vuln_id` string, required
    - `target` string, required
    - `template_url` string
    - `created_at` string, required
    - `updated_at` string
    - `scan_id` string, required
    - `event` VulnerabilityEvent[], required
      - `curl-command` string
      - `extracted-results` string[]
      - `extractor-name` string
      - `host` string
      - `info` object, required
        - `classification` object
          - `cpe` string
          - `cve-id` string[]
          - `cvss-metrics` string
          - `cvss-score` number
          - `cwe-id` string[]
          - `epss-percentile` number
          - `epss-score` number
        - `metadata` object
        - `author` string[]
        - `description` string
        - `impact` string
        - `name` string, required
        - `tags` string[]
        - `reference` string[]
        - `remediation` string
        - `severity` string
      - `ip` string
      - `matched-at` string
      - `matched-line` integer[]
      - `matcher-name` string
      - `matcher-status` boolean
      - `path` string
      - `request` string
      - `response` string
      - `template-id` string
      - `template-path` string
      - `timestamp` string
      - `type` string
    - `template_id` string, required
    - `template_path` string
    - `template_encoded` string
    - `result_type` string, required
    - `vuln_status` string

## Other responses

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

## Changes

- **2024-01-31** `4f557b176ebd` — 5 breaking, 9 warning, 40 info
  - the request property `target` became required
  - the request property `vuln_id` became required
  - the `results/event/items/extracted-results` response's property type changed from `string` to `array` for status `200`
  - the `results/event/items/extracted-results` response's property type changed from `string` to `array` for status `401`
  - …50 more
- **2023-12-06** `35be9c1301b7` — 1 info
  - api tag `retest` added
- **2023-12-05** `5c3748c387f7` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/projectdiscovery/apis/pdcp-api/changes/v1/retest/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/4f557b176ebd/schema)