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

TargetPause

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

This function will allow you to pause an existing scan.

Roles Required: Admin. Private Users and Users can only Pause Scans they initiated.

Request Syntax

{

"apiKey": "string",

"tokens": "String"

}


Request Parameters

Parameters being used in the Request

Parameter Name :

apiKey

Parameter Usage and Options :

Your CYTRIX 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 :

tokens

Parameter Usage and Options :

The scan’s tokens: (e.g. “xxxxxxxx-xxxx-xxx-xxxxxxxx”)

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 :

String

Is it Optional ? :

No.


Successful Response

{
    "Error": 0,
    "Function": "TargetPause",
    "Data": "Target Pause" / "Paused 2/2 Targets"
}

Errors and their Possible Causes

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