StateSet API Docs

curl --request POST \ --url 'https://api.nsr.stateset.com/api/v1/reason/induce-rules' \ --header 'X-API-Key: YOUR_API_KEY' \ --header 'Content-Type: application/json' \ --data '{ "examples": [ { "features": [], "label": "string" } ], "min_confidence": 1, "min_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

InduceExample[]

required

number (float)

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

integer

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

Response

InduceRulesResponse

integer

required

InducedRuleView[]

required

Show InducedRuleView

string[]

required

number (float)

required

string

required

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 --request POST \
  --url 'https://api.nsr.stateset.com/api/v1/reason/induce-rules' \
  --header 'X-API-Key: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
  "examples": [
    {
      "features": [],
      "label": "string"
    }
  ],
  "min_confidence": 1,
  "min_support": 1
}'

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

​Request body

​Response

​Status codes

Request body

Response

Status codes