Induce candidate rules from labeled examples.

A safe, on-demand generalizer: the caller supplies examples and gets back candidate head :- body rules (association-rule mining, minimal…

POST /api/v1/reason/induce-rules

cURL

curl --request POST \
  --url 'https://api.nsr.stateset.com/api/v1/reason/induce-rules' \
  --header "X-API-Key: $STATESET_NSR_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
  "examples": [
    {
      "features": [],
      "label": "Replacement tent pole set"
    }
  ],
  "min_confidence": 7.5,
  "min_support": 1
}'

200

{
  "examples_analyzed": 1,
  "rules": [
    {
      "body": [],
      "confidence": 7.5,
      "head": "string",
      "support": 1
    }
  ]
}

A safe, on-demand generalizer: the caller supplies {features, label} examples and gets back candidate head :- body rules (association-rule mining, minimal antecedents, support/confidence gated). It returns suggestions only — nothing is written to the knowledge base. Review the output and add rules you trust via POST /api/v1/rules.

Required scope: write

Request body

InduceRulesRequest

examples · InduceExample[] · required

min_confidence · number (float)

Minimum fraction of matches sharing the label (default 0.8).

min_support · integer

Minimum examples matching a body before a rule is proposed (default 3).

Response

InduceRulesResponse

examples_analyzed · integer · required

rules · InducedRuleView[] · required

Show InducedRuleView

body · string[] · required

confidence · number (float) · required

head · string · required

support · integer · required

Status codes

Code	Meaning
200	Candidate rules with support/confidence
400	No examples provided
401	Unauthorized — missing or invalid credentials
403	Forbidden — the key/token lacks the required scope
422	Too many examples
429	Rate limited — see Retry-After / X-RateLimit-Reset

cURL

curl --request POST \
  --url 'https://api.nsr.stateset.com/api/v1/reason/induce-rules' \
  --header "X-API-Key: $STATESET_NSR_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
  "examples": [
    {
      "features": [],
      "label": "Replacement tent pole set"
    }
  ],
  "min_confidence": 7.5,
  "min_support": 1
}'

200

{
  "examples_analyzed": 1,
  "rules": [
    {
      "body": [],
      "confidence": 7.5,
      "head": "string",
      "support": 1
    }
  ]
}