curl --request GET \
--url 'https://api.nsr.stateset.com/api/v1/kb/diff' \
--header 'X-API-Key: YOUR_API_KEY'
{
"constraint_violations": {
"introduced": [
{
"constraint_id": null,
"constraint_name": null,
"details": null,
"entities": null,
"entity_names": null,
"message": null,
"severity": null
}
],
"resolved": [
{
"constraint_id": null,
"constraint_name": null,
"details": null,
"entities": null,
"entity_names": null,
"message": null,
"severity": null
}
]
},
"entities": {
"added": [
{
"entity_type": null,
"id": null,
"name": null,
"org_id": null
}
],
"removed": [
{
"entity_type": null,
"id": null,
"name": null,
"org_id": null
}
]
},
"from": "string",
"org_id": "string",
"rules": {
"added": [
{
"body_predicates": null,
"confidence": null,
"enabled": null,
"head_predicate": null,
"id": null,
"name": null,
"org_id": null,
"priority": null
}
],
"modified": [
{
"after": null,
"before": null,
"id": null,
"name": null
}
],
"removed": [
{
"body_predicates": null,
"confidence": null,
"enabled": null,
"head_predicate": null,
"id": null,
"name": null,
"org_id": null,
"priority": null
}
]
},
"snapshots": {
"from": {
"as_of": "2026-07-24T12:00:00Z",
"entity_count": 1,
"events_applied": 1,
"rule_count": 1,
"triple_count": 1
},
"to": {
"as_of": "2026-07-24T12:00:00Z",
"entity_count": 1,
"events_applied": 1,
"rule_count": 1,
"triple_count": 1
}
},
"summary": {
"added_entities": 1,
"added_rules": 1,
"added_triples": 1,
"introduced_constraint_violations": 1,
"modified_rules": 1,
"removed_entities": 1,
"removed_rules": 1,
"removed_triples": 1,
"resolved_constraint_violations": 1
},
"to": "string",
"triples": {
"added": [
{
"confidence": null,
"object": null,
"object_name": null,
"org_id": null,
"predicate": null,
"subject": null,
"subject_name": null,
"valid_from": null,
"valid_to": null
}
],
"removed": [
{
"confidence": null,
"object": null,
"object_name": null,
"org_id": null,
"predicate": null,
"subject": null,
"subject_name": null,
"valid_from": null,
"valid_to": null
}
]
},
"truncated": true
}
Handler for GET /api/v1/kb/diff
Required scope: read
GET
/
api
/
v1
/
kb
/
diff
curl --request GET \
--url 'https://api.nsr.stateset.com/api/v1/kb/diff' \
--header 'X-API-Key: YOUR_API_KEY'
{
"constraint_violations": {
"introduced": [
{
"constraint_id": null,
"constraint_name": null,
"details": null,
"entities": null,
"entity_names": null,
"message": null,
"severity": null
}
],
"resolved": [
{
"constraint_id": null,
"constraint_name": null,
"details": null,
"entities": null,
"entity_names": null,
"message": null,
"severity": null
}
]
},
"entities": {
"added": [
{
"entity_type": null,
"id": null,
"name": null,
"org_id": null
}
],
"removed": [
{
"entity_type": null,
"id": null,
"name": null,
"org_id": null
}
]
},
"from": "string",
"org_id": "string",
"rules": {
"added": [
{
"body_predicates": null,
"confidence": null,
"enabled": null,
"head_predicate": null,
"id": null,
"name": null,
"org_id": null,
"priority": null
}
],
"modified": [
{
"after": null,
"before": null,
"id": null,
"name": null
}
],
"removed": [
{
"body_predicates": null,
"confidence": null,
"enabled": null,
"head_predicate": null,
"id": null,
"name": null,
"org_id": null,
"priority": null
}
]
},
"snapshots": {
"from": {
"as_of": "2026-07-24T12:00:00Z",
"entity_count": 1,
"events_applied": 1,
"rule_count": 1,
"triple_count": 1
},
"to": {
"as_of": "2026-07-24T12:00:00Z",
"entity_count": 1,
"events_applied": 1,
"rule_count": 1,
"triple_count": 1
}
},
"summary": {
"added_entities": 1,
"added_rules": 1,
"added_triples": 1,
"introduced_constraint_violations": 1,
"modified_rules": 1,
"removed_entities": 1,
"removed_rules": 1,
"removed_triples": 1,
"resolved_constraint_violations": 1
},
"to": "string",
"triples": {
"added": [
{
"confidence": null,
"object": null,
"object_name": null,
"org_id": null,
"predicate": null,
"subject": null,
"subject_name": null,
"valid_from": null,
"valid_to": null
}
],
"removed": [
{
"confidence": null,
"object": null,
"object_name": null,
"org_id": null,
"predicate": null,
"subject": null,
"subject_name": null,
"valid_from": null,
"valid_to": null
}
]
},
"truncated": true
}
Required scope:
read
Query parameters
string
required
RFC3339 start timestamp
string
required
RFC3339 end timestamp
string
Optional org filter
Response
KBDiffResponse
ConstraintViolationDiffSection
required
Show ConstraintViolationDiffSection
Show ConstraintViolationDiffSection
ConstraintViolationDiffItem[]
required
EntityDiffSection
required
string
required
string
RuleDiffSection
required
Show RuleDiffSection
Show RuleDiffSection
RuleDiffItem[]
required
ModifiedRuleDiffItem[]
required
KBDiffSnapshots
required
KBDiffSummary
required
string
required
TripleDiffSection
required
Show TripleDiffSection
Show TripleDiffSection
TripleDiffItem[]
required
boolean
required
True when any section was truncated by the
limit parameterStatus codes
| Code | Meaning |
|---|---|
200 | Diff between two KB snapshots |
400 | Invalid timestamp window |
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 GET \
--url 'https://api.nsr.stateset.com/api/v1/kb/diff' \
--header 'X-API-Key: YOUR_API_KEY'
{
"constraint_violations": {
"introduced": [
{
"constraint_id": null,
"constraint_name": null,
"details": null,
"entities": null,
"entity_names": null,
"message": null,
"severity": null
}
],
"resolved": [
{
"constraint_id": null,
"constraint_name": null,
"details": null,
"entities": null,
"entity_names": null,
"message": null,
"severity": null
}
]
},
"entities": {
"added": [
{
"entity_type": null,
"id": null,
"name": null,
"org_id": null
}
],
"removed": [
{
"entity_type": null,
"id": null,
"name": null,
"org_id": null
}
]
},
"from": "string",
"org_id": "string",
"rules": {
"added": [
{
"body_predicates": null,
"confidence": null,
"enabled": null,
"head_predicate": null,
"id": null,
"name": null,
"org_id": null,
"priority": null
}
],
"modified": [
{
"after": null,
"before": null,
"id": null,
"name": null
}
],
"removed": [
{
"body_predicates": null,
"confidence": null,
"enabled": null,
"head_predicate": null,
"id": null,
"name": null,
"org_id": null,
"priority": null
}
]
},
"snapshots": {
"from": {
"as_of": "2026-07-24T12:00:00Z",
"entity_count": 1,
"events_applied": 1,
"rule_count": 1,
"triple_count": 1
},
"to": {
"as_of": "2026-07-24T12:00:00Z",
"entity_count": 1,
"events_applied": 1,
"rule_count": 1,
"triple_count": 1
}
},
"summary": {
"added_entities": 1,
"added_rules": 1,
"added_triples": 1,
"introduced_constraint_violations": 1,
"modified_rules": 1,
"removed_entities": 1,
"removed_rules": 1,
"removed_triples": 1,
"resolved_constraint_violations": 1
},
"to": "string",
"triples": {
"added": [
{
"confidence": null,
"object": null,
"object_name": null,
"org_id": null,
"predicate": null,
"subject": null,
"subject_name": null,
"valid_from": null,
"valid_to": null
}
],
"removed": [
{
"confidence": null,
"object": null,
"object_name": null,
"org_id": null,
"predicate": null,
"subject": null,
"subject_name": null,
"valid_from": null,
"valid_to": null
}
]
},
"truncated": true
}