Events | Parallels REST API

Parallels REST API

Products Support Partners Documentation

Get

get

Retrieves a notification event by ID

Path parameters

idinteger · int32required

Notification event ID

Responses

application/json; api-version=1.0

cURL

JavaScript

Python

HTTP

curl -L \
  --url '/api/Notifications/{id}/Events'

200

401

404

{
  "id": 1,
  "adminCreate": "text",
  "adminLastMod": "text",
  "timeCreate": "2025-04-06T01:37:22.592Z",
  "timeLastMod": "2025-04-06T01:37:22.592Z",
  "siteId": 1,
  "enabled": true,
  "hasThreshold": true,
  "type": [
    "0 = Unknown",
    "4096 = CPU",
    "8192 = Memory",
    "12288 = RDSH",
    "16384 = Agent",
    "20480 = VDI",
    "24576 = PubItem",
    "28672 = License",
    "32768 = Authentication",
    "36864 = Gateway",
    "40960 = Disk",
    "45056 = Tenant",
    "1097729 = FailedTunneledSess",
    "1097730 = FailedTunneledSessTenantBroker",
    "17829888 = CPUEvent",
    "17833984 = MemoryEvent",
    "17838081 = RDSHConnectedSessionEvent",
    "17838082 = RDSHDisconnectedSessionEvent",
    "17862657 = TunneledSess",
    "34615299 = RDSHConnectedSessionEventPerc",
    "34615300 = RDSHDisconnectedSessionEventPerc",
    "34660353 = AVDActiveSessionsUtilization",
    "34660354 = AVDDisconnectedSessionsUtilization"
  ],
  "recipients": "text",
  "executeScript": true,
  "scriptId": 1,
  "sendEmail": true,
  "gracePeriod": 1,
  "enableGracePeriod": true,
  "interval": 1,
  "enableInterval": true,
  "waitUntilRecovered": true,
  "allServers": true,
  "targetType": [
    "0 = AllServers",
    "3 = Gateways",
    "5 = RemotePCs",
    "7 = PublishingAgents",
    "10 = VDIHostPools",
    "16 = RDSHGroups",
    "46 = EnrollmentServers",
    "65 = AVDHostPools",
    "-1 = ForceAllAgents"
  ],
  "targetIds": [
    1
  ]
}

Success

Delete

delete

Delete an event notification by ID.

Path parameters

idinteger · int32required

Event notification ID

Responses

application/json; api-version=1.0

cURL

JavaScript

Python

HTTP

curl -L \
  --request DELETE \
  --url '/api/Notifications/{id}/Events'

204

401

404

No Content

List

get

Retrieves all notification events configurations

Query parameters

SiteIdinteger · int32optional

Site ID for which to retrieve notification events (optional)

Responses

application/json; api-version=1.0

cURL

JavaScript

Python

HTTP

curl -L \
  --url '/api/Notifications/Events'

200

401

404

[
  {
    "id": 1,
    "adminCreate": "text",
    "adminLastMod": "text",
    "timeCreate": "2025-04-06T01:37:22.592Z",
    "timeLastMod": "2025-04-06T01:37:22.592Z",
    "siteId": 1,
    "enabled": true,
    "hasThreshold": true,
    "type": [
      "0 = Unknown",
      "4096 = CPU",
      "8192 = Memory",
      "12288 = RDSH",
      "16384 = Agent",
      "20480 = VDI",
      "24576 = PubItem",
      "28672 = License",
      "32768 = Authentication",
      "36864 = Gateway",
      "40960 = Disk",
      "45056 = Tenant",
      "1097729 = FailedTunneledSess",
      "1097730 = FailedTunneledSessTenantBroker",
      "17829888 = CPUEvent",
      "17833984 = MemoryEvent",
      "17838081 = RDSHConnectedSessionEvent",
      "17838082 = RDSHDisconnectedSessionEvent",
      "17862657 = TunneledSess",
      "34615299 = RDSHConnectedSessionEventPerc",
      "34615300 = RDSHDisconnectedSessionEventPerc",
      "34660353 = AVDActiveSessionsUtilization",
      "34660354 = AVDDisconnectedSessionsUtilization"
    ],
    "recipients": "text",
    "executeScript": true,
    "scriptId": 1,
    "sendEmail": true,
    "gracePeriod": 1,
    "enableGracePeriod": true,
    "interval": 1,
    "enableInterval": true,
    "waitUntilRecovered": true,
    "allServers": true,
    "targetType": [
      "0 = AllServers",
      "3 = Gateways",
      "5 = RemotePCs",
      "7 = PublishingAgents",
      "10 = VDIHostPools",
      "16 = RDSHGroups",
      "46 = EnrollmentServers",
      "65 = AVDHostPools",
      "-1 = ForceAllAgents"
    ],
    "targetIds": [
      1
    ]
  }
]

Success

Create

post

A configuration of an event notification such as license activation, agent disconnect/connect etc

Body

siteIdinteger · int32optional

Site ID where notification event is setup. Current site ID is used if siteId is omitted.

gracePeriodinteger · int32optional

Grace period after the notification was done (minutes).

enableGracePeriodbooleanoptional

Enable/Disable grace period.

recipientsstring[] | nullableoptional

Recipients to notify of the event.

sendEmailbooleanoptional

Enable/Disable email notification.

scriptIdinteger · int32optional

Script to execute which has this ID.

executeScriptbooleanoptionalDefault: false

intervalinteger · int32optional

Invocation interval (minutes).

enableIntervalbooleanoptional

Enable/Disable notification intervals.

Default: false

waitUntilRecoveredbooleanoptional

Wait until recovered.

Default: false

allServersboolean | nullableoptional

All servers in site.

targetTypestring · enumoptional

Target Type

Available options:

targetIdsinteger · int32[] | nullableoptional

Target Ids.

typestring · enumrequired

RAS Notification Event Type

Available options:

Responses

application/json; api-version=1.0

cURL

JavaScript

Python

HTTP

curl -L \
  --request POST \
  --url '/api/Notifications/Events' \
  --header 'Content-Type: application/json; api-version=1.0' \
  --data '{
    "siteId": 1,
    "gracePeriod": 1,
    "enableGracePeriod": true,
    "recipients": [
      "text"
    ],
    "sendEmail": true,
    "scriptId": 1,
    "executeScript": true,
    "interval": 1,
    "enableInterval": true,
    "waitUntilRecovered": true,
    "allServers": true,
    "targetType": [
      "0 = AllServers",
      "3 = Gateways",
      "5 = RemotePCs",
      "7 = PublishingAgents",
      "10 = VDIHostPools",
      "16 = RDSHGroups",
      "46 = EnrollmentServers",
      "65 = AVDHostPools",
      "-1 = ForceAllAgents"
    ],
    "targetIds": [
      1
    ],
    "type": [
      "16384 = Agent",
      "20480 = VDI",
      "24576 = PubItem",
      "28672 = License",
      "32768 = Authentication",
      "45056 = Tenant",
      "1097729 = FailedTunneledSess"
    ]
  }'

201

401

409

{
  "id": 1,
  "adminCreate": "text",
  "adminLastMod": "text",
  "timeCreate": "2025-04-06T01:37:22.592Z",
  "timeLastMod": "2025-04-06T01:37:22.592Z",
  "siteId": 1,
  "enabled": true,
  "hasThreshold": true,
  "type": [
    "0 = Unknown",
    "4096 = CPU",
    "8192 = Memory",
    "12288 = RDSH",
    "16384 = Agent",
    "20480 = VDI",
    "24576 = PubItem",
    "28672 = License",
    "32768 = Authentication",
    "36864 = Gateway",
    "40960 = Disk",
    "45056 = Tenant",
    "1097729 = FailedTunneledSess",
    "1097730 = FailedTunneledSessTenantBroker",
    "17829888 = CPUEvent",
    "17833984 = MemoryEvent",
    "17838081 = RDSHConnectedSessionEvent",
    "17838082 = RDSHDisconnectedSessionEvent",
    "17862657 = TunneledSess",
    "34615299 = RDSHConnectedSessionEventPerc",
    "34615300 = RDSHDisconnectedSessionEventPerc",
    "34660353 = AVDActiveSessionsUtilization",
    "34660354 = AVDDisconnectedSessionsUtilization"
  ],
  "recipients": "text",
  "executeScript": true,
  "scriptId": 1,
  "sendEmail": true,
  "gracePeriod": 1,
  "enableGracePeriod": true,
  "interval": 1,
  "enableInterval": true,
  "waitUntilRecovered": true,
  "allServers": true,
  "targetType": [
    "0 = AllServers",
    "3 = Gateways",
    "5 = RemotePCs",
    "7 = PublishingAgents",
    "10 = VDIHostPools",
    "16 = RDSHGroups",
    "46 = EnrollmentServers",
    "65 = AVDHostPools",
    "-1 = ForceAllAgents"
  ],
  "targetIds": [
    1
  ]
}

Created

Update

put

Update event notification by ID.

Path parameters

idinteger · int32required

Event notification ID

Body

enabledboolean | nullableoptional

Enable/Disable notification.

gracePeriodinteger · int32 | nullableoptional

Notification grace period (minutes).

enableGracePeriodboolean | nullableoptional

Enable/Disable grace period.

recipientsstring[] | nullableoptional

Notification recipients.

sendEmailboolean | nullableoptional

Enable/Disable email notification.

scriptIdinteger · int32 | nullableoptional

Use script of given ID.

executeScriptboolean | nullableoptional

Enable/Disable notification scripts.

intervalinteger · int32 | nullableoptional

Notification interval (minutes).

enableIntervalboolean | nullableoptional

Enable/Disable notification intervals.

waitUntilRecoveredboolean | nullableoptional

Wait until recovered.

allServersboolean | nullableoptional

All servers in site.

targetTypestring · enumoptional

Target Type

Available options:

targetIdsinteger · int32[] | nullableoptional

Target IDs.

Responses

application/json; api-version=1.0

cURL

JavaScript

Python

HTTP

curl -L \
  --request PUT \
  --url '/api/Notifications/{id}/Events' \
  --header 'Content-Type: application/json; api-version=1.0' \
  --data '{
    "enabled": true,
    "gracePeriod": 1,
    "enableGracePeriod": true,
    "recipients": [
      "text"
    ],
    "sendEmail": true,
    "scriptId": 1,
    "executeScript": true,
    "interval": 1,
    "enableInterval": true,
    "waitUntilRecovered": true,
    "allServers": true,
    "targetType": [
      "0 = AllServers",
      "3 = Gateways",
      "5 = RemotePCs",
      "7 = PublishingAgents",
      "10 = VDIHostPools",
      "16 = RDSHGroups",
      "46 = EnrollmentServers",
      "65 = AVDHostPools",
      "-1 = ForceAllAgents"
    ],
    "targetIds": [
      1
    ]
  }'

204

401

404

No Content