Skip to content

CANCEL_RENEWAL

Cancel policy renewal

Submit this event using Firing an Event. Product configuration and enabled actions determine the workflow behavior. Use identifiers and snapshots from the same environment.

Request payload#

HTTPPOST
POST https://api.{ENV}.dais.com/ioi/v3/event/fire
cURL
curl --location --request POST 'https://api.{ENV}.dais.com/ioi/v3/event/fire' \
--header 'Authorization: Basic <Base64-encoded API key and secret>' \
--header 'Content-Type: application/json' \
--data-raw '{
  "lineId": "<UUID of the product ID>",
  "type": "CANCEL_RENEWAL",
  "payload": {
    "policyId": "<UUID of the policy ID>",
    "clientId": "<UUID of the client ID>",
    "quoteId": "<UUID of the quote request ID>",
    "configId": "<UUID of the configuration ID>",
    "label": "<Label>",
    "documents": [],
    "backofficeIntake": {
      "cancelReason": {
        "type": "ANSWER",
        "answer": "<Answer for this question>"
      },
      "cancellationDate": {
        "type": "ANSWER",
        "answer": "2026-12-01"
      }
    }
  }
}'
JSON
{
  "lineId": "<UUID of the product ID>",
  "type": "CANCEL_RENEWAL",
  "payload": {
    "policyId": "<UUID of the policy ID>",
    "clientId": "<UUID of the client ID>",
    "quoteId": "<UUID of the quote request ID>",
    "configId": "<UUID of the configuration ID>",
    "label": "<Label>",
    "documents": [],
    "backofficeIntake": {
      "cancelReason": {
        "type": "ANSWER",
        "answer": "<Answer for this question>"
      },
      "cancellationDate": {
        "type": "ANSWER",
        "answer": "2026-12-01"
      }
    }
  }
}

Request Fields#

See the shared event envelope. Set type to CANCEL_RENEWAL and provide the payload below.

Payload Fields#

Required fields include the inputs used by this event's built-in action. Configured actions can require additional data.

PropertyRequiredDescription
policyIdYesUUID of the policy whose renewal is being cancelled.
clientIdNoUUID of the client who owns the policy identified by policyId.
quoteIdNoUUID of the original quote associated with the policy identified by policyId.
configIdYesUUID of the cancellation configuration that defines which actions to trigger.
labelNoHuman-readable description of the cancellation.
documentsNoList of documents related to the event.
backofficeIntakeNoMap of question IDs to answers for backoffice-configured intake fields.

Response#

This example illustrates the common trigger response structure. Action counts and metadata depend on the actions that run; action-specific result fields are described where applicable.

JSON
{
  "triggerRequestId": "<UUID of the trigger request ID>",
  "executedActionCount": 0,
  "expectedResponseCount": 0,
  "metadata": {}
}

Response Fields#

PropertyDescription
triggerRequestIdUUID identifying this trigger execution.
executedActionCountNumber of actions reported as executed.
expectedResponseCountNumber of expected action responses.
metadataAction-specific results; may be empty.

See Firing an Event for execution modes and response handling.