StateSet API Docs

curl --request POST \ --url 'https://api.nsr.stateset.com/api/v1/explain' \ --header 'X-API-Key: YOUR_API_KEY' \ --header 'Content-Type: application/json' \ --data '{ "query": "string", "session_id": "string", "style": "string" }'

Generate a post-hoc explanation for a query. Required scope: write

Request body

ExplainRequest

string

required

The query to explain

string

Session ID for context

string

Explanation style: ‘symbolic’, ‘neural’, ‘contrastive’

Response

ExplainResponse

object

Show components

string[]

required

Key decision points

string

required

Perception explanation

string

required

Semantic computation explanation

string

required

Syntax (parsing) explanation

boolean

required

Whether explainability is enabled

string

Human-readable explanation

Status codes

Code	Meaning
`200`	Explanation generated
`400`	Invalid request
`401`	Unauthorized — missing or invalid credentials
`403`	Forbidden — the key/token lacks the required scope
`429`	Rate limited — see Retry-After / X-RateLimit-Reset
`500`	Failed to generate explanation

curl --request POST \
  --url 'https://api.nsr.stateset.com/api/v1/explain' \
  --header 'X-API-Key: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
  "query": "string",
  "session_id": "string",
  "style": "string"
}'

{
  "components": {
    "decision_points": [
      "string"
    ],
    "perception": "string",
    "semantics": "string",
    "syntax": "string"
  },
  "enabled": true,
  "explanation": "string"
}

​Request body

​Response

​Status codes

Request body

Response

Status codes