Malware

Set scan-notification settings

Enable/disable scheduled scanning + email notifications and set recipients + schedule for a hosting service.

put/v1/malware/services/{service_id}/notify

Request

  • Base URL: https://developers.servera.co.uk
  • URL: https://developers.servera.co.uk/v1/malware/services/{service_id}/notify
  • Auth: HTTP bearer

Path parameters

service_idinteger required

Service id of the VPS/VDS (from GET /vps) or Virtual Router (from GET /virtual-routers).

Request body

enabledboolean

Turn scheduled malicious-code scanning + email notifications on/off for this service.

recipient_emailsstring[]

Who receives the report email. Max 20. You may include or omit the account owner.

cadencestring

How often to scan: daily | weekly | monthly.

hourinteger

Hour of day (Europe/Vilnius).

minuteinteger

Minute of hour (Europe/Vilnius).

day_of_weekinteger

Weekly cadence only: 0=Monday … 6=Sunday.

day_of_monthinteger

Monthly cadence only: day 1–28.

notify_on_cleanboolean

Also email the report when a scan finds 0 malware (default: only email when threats are found).

Example request

{
  "cadence": "weekly",
  "day_of_week": 0,
  "enabled": true,
  "hour": 3,
  "minute": 30,
  "notify_on_clean": false,
  "recipient_emails": [
    "me@example.lt",
    "dev@example.lt"
  ]
}

Response

Successful Response

unknown required

Changes

No recorded changes to this operation across all 1 revision of this API.