StateSet API Docs

curl --request POST \
  --url 'https://api.nsr.stateset.com/v1/decisions/impact' \
  --header 'X-API-Key: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
  "add_rules": [
    {
      "category": "string",
      "constraints": [],
      "description": "string",
      "effect": {
        "0": "p",
        "1": "e",
        "2": "r",
        "3": "m",
        "4": "i",
        "5": "t"
      },
      "enabled": true,
      "id": "string",
      "if": [],
      "name": "string",
      "priority": 1,
      "then": []
    }
  ],
  "limit": 1,
  "remove_rules": [
    "string"
  ]
}'

{
  "candidate_outcomes": {},
  "evaluated": 1,
  "flips": [
    {
      "baseline": {
        "cited_rules": null,
        "outcome": null,
        "reason": null
      },
      "candidate": {
        "cited_rules": null,
        "outcome": null,
        "reason": null
      },
      "decision_id": "string",
      "original_outcome": "string",
      "query": "string"
    }
  ],
  "scope": "string",
  "skipped_no_snapshot": 1
}

POST

decisions

impact

curl --request POST \
  --url 'https://api.nsr.stateset.com/v1/decisions/impact' \
  --header 'X-API-Key: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
  "add_rules": [
    {
      "category": "string",
      "constraints": [],
      "description": "string",
      "effect": {
        "0": "p",
        "1": "e",
        "2": "r",
        "3": "m",
        "4": "i",
        "5": "t"
      },
      "enabled": true,
      "id": "string",
      "if": [],
      "name": "string",
      "priority": 1,
      "then": []
    }
  ],
  "limit": 1,
  "remove_rules": [
    "string"
  ]
}'

{
  "candidate_outcomes": {},
  "evaluated": 1,
  "flips": [
    {
      "baseline": {
        "cited_rules": null,
        "outcome": null,
        "reason": null
      },
      "candidate": {
        "cited_rules": null,
        "outcome": null,
        "reason": null
      },
      "decision_id": "string",
      "original_outcome": "string",
      "query": "string"
    }
  ],
  "scope": "string",
  "skipped_no_snapshot": 1
}

decisions. Dry-run: bills nothing, logs nothing, persists nothing. Required scope: write

Request body

PolicyImpactRequest

RecursiveChatRuleInput[]

Rules to ADD to the org policy for the candidate replay. Evaluated org-side (target-binding and declared-effect semantics identical to a stored org rule). Each rule must have exactly one conclusion.

integer

Max logged decisions to replay, newest first (default 100, cap 500).

string[]

Names of existing org rules to REMOVE for the candidate replay.

Response

PolicyImpactResponse

object

required

Verdict counts under the candidate policy, flipped or not.

integer

required

Records replayed (had a request snapshot).

PolicyImpactFlip[]

required

Show PolicyImpactFlip

PolicyVerdict

required

Show PolicyVerdict

string[]

required

string

required

approved | denied | refused — from the same outcome gate as live.

string

required

PolicyVerdict

required

Show PolicyVerdict

string[]

required

string

required

approved | denied | refused — from the same outcome gate as live.

string

required

string

required

string

required

The outcome the platform originally returned (includes neural context; shown for reference, not the comparison baseline).

string

required

string

required

What this replay does and does not evaluate.

integer

required

Records skipped because they carried no request snapshot.

Status codes

Code	Meaning
`200`	Counterfactual replay report: outcome flips under the candidate policy
`400`	A candidate rule cannot be represented as a stored org rule (multiple conclusions or a declared effect)
`401`	Unauthorized — missing or invalid credentials
`403`	Forbidden — the key/token lacks the required scope
`429`	Rate limited — see Retry-After / X-RateLimit-Reset

curl --request POST \
  --url 'https://api.nsr.stateset.com/v1/decisions/impact' \
  --header 'X-API-Key: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
  "add_rules": [
    {
      "category": "string",
      "constraints": [],
      "description": "string",
      "effect": {
        "0": "p",
        "1": "e",
        "2": "r",
        "3": "m",
        "4": "i",
        "5": "t"
      },
      "enabled": true,
      "id": "string",
      "if": [],
      "name": "string",
      "priority": 1,
      "then": []
    }
  ],
  "limit": 1,
  "remove_rules": [
    "string"
  ]
}'

{
  "candidate_outcomes": {},
  "evaluated": 1,
  "flips": [
    {
      "baseline": {
        "cited_rules": null,
        "outcome": null,
        "reason": null
      },
      "candidate": {
        "cited_rules": null,
        "outcome": null,
        "reason": null
      },
      "decision_id": "string",
      "original_outcome": "string",
      "query": "string"
    }
  ],
  "scope": "string",
  "skipped_no_snapshot": 1
}

​Request body

​Response

​Status codes

Request body

Response

Status codes