1. Home
  2. Docs
  3. API Documentation
  4. Schedule
  5. DeleteSchedule

DeleteSchedule

Route: https://api.kayran.live/DeleteSchedule

This function allow you to delete scheduled scans.

Note : doing so, won’t delete any previous occurrences of this Target, but you won’t be able to fetch this scheduled scan after being deleted.

Roles Required: Admin. Users and Private Users can only Delete Scans they have Scheduled.

Request Syntax

{

“apiKey”: “string”,

“scheduleId”: “String”,

“scheduleIds”: [“String”, “String”]

}


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 :

scheduleId

Parameter Usage and Options :

The scheduled scan’s ID.

How do I get it ? :

Simply use the “GetSchedule” function, or navigate to a certain scheduled scan’s page, and in the address bar, you will notice “id=12315456”, use that number

Type :

Integer

Is it Optional ? :

No.


Parameter Name :

scheduleIds

Parameter Usage and Options :

Same as “scheduleId”, only for cases you wish to address a number of scheduled scans.

How do I get it ? :

Simply use the “GetSchedule” function, or navigate to a certain scheduled scan’s page, and in the address bar, you will notice “id=12315456”, use that number.

Type :

Integer

Is it Optional ? :

Yes\No – depends on whether you wish to address a number of scheduled scans.


Successful Response

{
“Error”: 0,
“Function”: “DeleteSchedule”,
“Data”: {
“0”: {
“schedule_id”: 123456,
“code”: 0,
“info”: “Deleted target schedule URL”
}
}
}

Errors and their Possible Causes

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