1. Home
  2. Docs
  3. API Documentation
  4. Scans – Create
  5. Retest

Retest

Route: https://api.cytrix.io/Retest

Using this feature will allow you to retest each Vulnerability.

Roles Required: Admin and User. Private Users can only Retest Vulnerabilities from Scans they created.

Request Syntax

{
        "apiKey": "String",    "token": "String",
    "vulnId": Integer
}

Request Parameters

Parameters being used in the Request

Parameter Name :

apiKey

Parameter Usage and Options :

Your Kayran given API Key.

How do I get it ? :

Located in the “Profile” section.

Note : by default, the “API Status” is enabled, unless, the Admin has disabled it in the “Server Settings” section.

Type :

String

Is it Optional ? :

No.


Parameter Name :
vulnId

Parameter Usage and Options :

Id of the requested vulnerability.

How do I get it ? :

By entering the vulnerability page in Kayran, on the address bar, the “id=231231232133”, use the number that appears. You can also use the “GetAllVulns”, “GetVulnsScan” or the “GetScan” functions.

Type :

Integer

Is it Optional ? :

No.


Parameter Name :
token

Parameter Usage and Options :

The scan’s Token

How do I get it ? :

Simply use the “GetScan” or “GetAllScans” function, or navigate to a certain scan’s page, and in the address bar, you will notice “token=String”, use that String.

Type :

Strings

Is it Optional ? :

No.


Successful Response



{
    "Error": 0,
    "Function": "Retest",
    "Data": "OK;{token}"
}

Errors and their Possible Causes

For more information, please refer to the General Errors section.