Create peril converter job

Creates a PERIL_CONVERTER job that updates peril coverage settings in the policies assigned to the specified list of accounts and portfolios.

A PERIL_CONVERTER job updates the location coverage applied to a list of exposures (account and portfolio resources) by converting the existing peril (as defined in the sourcePeril parameter) into another peril or list of perils (as defined in the targetPerils parameter).

This operation accepts four required parameters: the x-rms-resource-group-id header parameter and the resourceUris, resourceTypes, and settings body parameters.

The sourcePeril and targetPeril objects select and update the perils covered by each policy in the request. In each object, perils are identified by the peril, newCauseOfLoss, or CauseOfLoss values. The parameters specified depend on the whether peril coverage is defined in a policy or HD step policy.

Policies and Non-HD Step Policies

If peril coverage of the specified resourceUrls is defined by a policy or step policy, the settings object can identify source and target perils by peril value (for DLM models) or a combination of peril and newCauseOfLoss values (for HD models).

{
  "resourceUris": ["/platform/riskdata/v1/exposures/{exposureId}/portfolios/2"],
  "resourceTypes": ["portfolios"],
  "settings": {
    "sourcePeril": {
      "peril": 2,
      "newCauseOfLoss": 27
    },
    "targetPerils": [
      {
        "peril": 4,
        "newCauseOfLoss": 28
      }
    ]
  }
}

The peril and newCauseOfLoss parameters accept integer values that identify the perils to be updated.

The peril parameter represents an EDM schema field (RMS_EDM.policy.POLICYTYPE). that identifies the perils that impact a policy or step policy regardless of peril model. The peril parameter can be used for both DLM and HD models.

The newCauseOfLoss parameter represents an EDM schema field (RMS_EDM.policy.NEWCAUSEOFLOSS) that identifies the perils that impact a policy or step policy. The newCauseOfLoss parameter can be used for HD models only.

HD Step Policies

If peril coverage of the specified resourceUrls is defined by a HD step policy, the settings object can identify source and target perils by causeOfLoss values.

{
  "resourceUris": ["/platform/riskdata/v1/exposures/{exposureId}/portfolios/2"],
  "resourceTypes": ["portfolios"],
  "settings": {
    "sourcePeril": {
      "causeOfLoss": 27
    },
    "targetPerils": [
      {
        "causeOfLoss": 28
      }
    ]
  }
}

The causeOfLoss parameter represents an EDM schema field (RMS_EDM.hdsteppolicy.CAUSEOFLOSS) that identifies the perils that impact a HD step policy. The CauseOfLoss parameter can be specified for HD models only.

Optional parameters

Peril conversion can optionally include sub-policy terms, endorsements, policy restrictions and sublimit restrictions.

/platform/perilconverter/v1/jobs createperilconverterjob countryCodesFilter createBackup includePolicyReinsurance includeSubPolicyConditions newCauseOfLoss newCauseOfLoss overwriteExistingCoverage peril peril resourceTypes resourceUris settings sourcePeril targetPerils