Executing rules by using the REST service

Decision Server provides a Representational State Transfer (REST) service for ruleset execution. You can use it to execute rulesets through the HTTP protocol by using the XML or the JSON format.


The REST service for ruleset execution provides XML and JSON generation, XSD validation, and execution services. The service is designed for the following benefits:
  • You do not need a client library or a complex configuration to interact with a remote Rule Execution Server instance.
  • You can work across environments or from various client applications, typically from JavaScript clients.
  • You can easily move from local to remote Rule Execution Server execution.
Deprecated feature:

Deprecation icon Execution using REST and XML (HTDS) is deprecated in V8.11.1. See Deprecated features for migration details.


To use the REST service for a ruleset execution, use the following process. See Executing a ruleset from a client.
  1. Deploy a valid ruleset. See Overview: Deployment options.
  2. Use the REST service to generate an XML or a JSON payload. The REST service provides XML and JSON generation, XSD validation, and execution services. You can test the generation of the payload and its execution from the Rule Execution Server console. See Testing ruleset REST execution.
  3. After you are familiar with the input and output format, send the request as the payload of an HTTP call through a POST method to the corresponding URI. See Executing a ruleset by creating a REST request.