Sign in

v1

latestOpenAPI 3.1.02026-07-261344388.3 KB
Decision

Simulate decision

Simulates a decision graph evaluation without persisting changes, useful for testing decision logic.

post/api/projects/{projectId}/decisions/simulate

Path parameters

projectIdstring uuid required

Unique identifier of the project

Request body

publishedboolean

Indicates if simulation should use published decisions or draft

releaseIdstring nullable

Optional release ID to use for loading dependent decisions

contextobject nullable

Evaluation context

{"stackTrail":"paths:/api/projects/{projectId}/decisions/simulate:post:requestBody:content:application/json:schema:properties:graph","oasType":"schema","type":"unknown","description":"Decision graph","example":{"edges":[{"id":"1dfbc57d-ad1f-4cf8-978a-e43241856fc8","type":"edge","sourceId":"be0a5c2d-538d-4e50-9843-91b274e1b9d8","targetId":"7c07550a-07bc-4ee4-80d6-9ad900e3d6c9"},{"id":"5e2dc187-3b82-4f21-94f5-9c3fd16e12d4","type":"edge","sourceId":"7c07550a-07bc-4ee4-80d6-9ad900e3d6c9","targetId":"72d52cfc-e866-4c11-bf79-6be9f750e4d7"}],"nodes":[{"id":"be0a5c2d-538d-4e50-9843-91b274e1b9d8","name":"Request","type":"inputNode","position":{"x":180,"y":280}},{"id":"7c07550a-07bc-4ee4-80d6-9ad900e3d6c9","name":"Fees","type":"decisionTableNode","content":{"rules":[{"_id":"vCqrZGdWjA","DA3Ybo-shA":"\"US\"","FD4qBBPv2G":"> 1000","JuUcECFGe1":"2","jrsT5Wg9F8":"\"gold\"","qA7iYc3Wle":""},{"_id":"CpXx-s78FH","DA3Ybo-shA":"\"US\"","FD4qBBPv2G":"> 1000","JuUcECFGe1":"3","jrsT5Wg9F8":"","qA7iYc3Wle":""},{"_id":"zH-PuRB2aQ","DA3Ybo-shA":"\"US\"","FD4qBBPv2G":"","JuUcECFGe1":"","jrsT5Wg9F8":"","qA7iYc3Wle":"25"},{"_id":"HjEp-eQhAP","DA3Ybo-shA":"\"CA\",\"MX\"","FD4qBBPv2G":"> 1000","JuUcECFGe1":"5","jrsT5Wg9F8":"","qA7iYc3Wle":""},{"_id":"nq40hJ1nXy","DA3Ybo-shA":"\"CA\",\"MX\"","FD4qBBPv2G":"","JuUcECFGe1":"","jrsT5Wg9F8":"","qA7iYc3Wle":"50"},{"_id":"G64ltgrVgV","DA3Ybo-shA":"\"IE\",\"UK\",\"FR\",\"DE\"","FD4qBBPv2G":"> 1000","JuUcECFGe1":"10","jrsT5Wg9F8":"","qA7iYc3Wle":""},{"_id":"PD3oYgtiDa","DA3Ybo-shA":"\"IE\",\"UK\",\"FR\",\"DE\"","FD4qBBPv2G":"","JuUcECFGe1":"","jrsT5Wg9F8":"","qA7iYc3Wle":"100"},{"_id":"1BY7iMFoDw","DA3Ybo-shA":"","FD4qBBPv2G":"> 1000","JuUcECFGe1":"15","jrsT5Wg9F8":"","qA7iYc3Wle":""},{"_id":"dlwJlbW7ZH","DA3Ybo-shA":"","FD4qBBPv2G":"","JuUcECFGe1":"","jrsT5Wg9F8":"","qA7iYc3Wle":"150"}],"inputs":[{"id":"FD4qBBPv2G","name":"Cart Total","type":"expression","field":"cart.total"},{"id":"DA3Ybo-shA","name":"Customer Country","type":"expression","field":"customer.country"},{"id":"jrsT5Wg9F8","name":"Customer Tier","type":"expression","field":"customer.tier"}],"outputs":[{"id":"qA7iYc3Wle","name":"Fees Flat ($)","type":"expression","field":"fees.flat"},{"id":"JuUcECFGe1","name":"Fees Percent","type":"expression","field":"fees.percent"}],"hitPolicy":"first"},"position":{"x":420,"y":280}},{"id":"72d52cfc-e866-4c11-bf79-6be9f750e4d7","name":"Response","type":"outputNode","position":{"x":670,"y":280}}]}}

Example request

{
  "context": {
    "cart": {
      "total": 1500
    },
    "customer": {
      "country": "US",
      "tier": "gold"
    }
  },
  "graph": {
    "edges": [
      {
        "id": "1dfbc57d-ad1f-4cf8-978a-e43241856fc8",
        "type": "edge",
        "sourceId": "be0a5c2d-538d-4e50-9843-91b274e1b9d8",
        "targetId": "7c07550a-07bc-4ee4-80d6-9ad900e3d6c9"
      },
      {
        "id": "5e2dc187-3b82-4f21-94f5-9c3fd16e12d4",
        "type": "edge",
        "sourceId": "7c07550a-07bc-4ee4-80d6-9ad900e3d6c9",
        "targetId": "72d52cfc-e866-4c11-bf79-6be9f750e4d7"
      }
    ],
    "nodes": [
      {
        "id": "be0a5c2d-538d-4e50-9843-91b274e1b9d8",
        "name": "Request",
        "type": "inputNode",
        "position": {
          "x": 180,
          "y": 280
        }
      },
      {
        "id": "7c07550a-07bc-4ee4-80d6-9ad900e3d6c9",
        "name": "Fees",
        "type": "decisionTableNode",
        "content": {
          "rules": [
            {
              "_id": "vCqrZGdWjA",
              "DA3Ybo-shA": "\"US\"",
              "FD4qBBPv2G": "> 1000",
              "JuUcECFGe1": "2",
              "jrsT5Wg9F8": "\"gold\"",
              "qA7iYc3Wle": ""
            },
            {
              "_id": "CpXx-s78FH",
              "DA3Ybo-shA": "\"US\"",
              "FD4qBBPv2G": "> 1000",
              "JuUcECFGe1": "3",
              "jrsT5Wg9F8": "",
              "qA7iYc3Wle": ""
            },
            {
              "_id": "zH-PuRB2aQ",
              "DA3Ybo-shA": "\"US\"",
              "FD4qBBPv2G": "",
              "JuUcECFGe1": "",
              "jrsT5Wg9F8": "",
              "qA7iYc3Wle": "25"
            },
            {
              "_id": "HjEp-eQhAP",
              "DA3Ybo-shA": "\"CA\",\"MX\"",
              "FD4qBBPv2G": "> 1000",
              "JuUcECFGe1": "5",
              "jrsT5Wg9F8": "",
              "qA7iYc3Wle": ""
            },
            {
              "_id": "nq40hJ1nXy",
              "DA3Ybo-shA": "\"CA\",\"MX\"",
              "FD4qBBPv2G": "",
              "JuUcECFGe1": "",
              "jrsT5Wg9F8": "",
              "qA7iYc3Wle": "50"
            },
            {
              "_id": "G64ltgrVgV",
              "DA3Ybo-shA": "\"IE\",\"UK\",\"FR\",\"DE\"",
              "FD4qBBPv2G": "> 1000",
              "JuUcECFGe1": "10",
              "jrsT5Wg9F8": "",
              "qA7iYc3Wle": ""
            },
            {
              "_id": "PD3oYgtiDa",
              "DA3Ybo-shA": "\"IE\",\"UK\",\"FR\",\"DE\"",
              "FD4qBBPv2G": "",
              "JuUcECFGe1": "",
              "jrsT5Wg9F8": "",
              "qA7iYc3Wle": "100"
            },
            {
              "_id": "1BY7iMFoDw",
              "DA3Ybo-shA": "",
              "FD4qBBPv2G": "> 1000",
              "JuUcECFGe1": "15",
              "jrsT5Wg9F8": "",
              "qA7iYc3Wle": ""
            },
            {
              "_id": "dlwJlbW7ZH",
              "DA3Ybo-shA": "",
              "FD4qBBPv2G": "",
              "JuUcECFGe1": "",
              "jrsT5Wg9F8": "",
              "qA7iYc3Wle": "150"
            }
          ],
          "inputs": [
            {
              "id": "FD4qBBPv2G",
              "name": "Cart Total",
              "type": "expression",
              "field": "cart.total"
            },
            {
              "id": "DA3Ybo-shA",
              "name": "Customer Country",
              "type": "expression",
              "field": "customer.country"
            },
            {
              "id": "jrsT5Wg9F8",
              "name": "Customer Tier",
              "type": "expression",
              "field": "customer.tier"
            }
          ],
          "outputs": [
            {
              "id": "qA7iYc3Wle",
              "name": "Fees Flat ($)",
              "type": "expression",
              "field": "fees.flat"
            },
            {
              "id": "JuUcECFGe1",
              "name": "Fees Percent",
              "type": "expression",
              "field": "fees.percent"
            }
          ],
          "hitPolicy": "first"
        },
        "position": {
          "x": 420,
          "y": 280
        }
      },
      {
        "id": "72d52cfc-e866-4c11-bf79-6be9f750e4d7",
        "name": "Response",
        "type": "outputNode",
        "position": {
          "x": 670,
          "y": 280
        }
      }
    ]
  }
}

Response

Successful simulation result with trace data

{"stackTrail":"paths:/api/projects/{projectId}/decisions/simulate:post:responses:200:content:application/json:schema:properties:result","oasType":"schema","type":"unknown","description":"The computed result from the decision evaluation"}
performancestring

Total execution time of the decision

traceobject

Detailed trace of each node execution when trace is enabled