curl --request POST \
--url 'https://api.nsr.stateset.com/api/v1/nsr/symbols' \
--header "X-API-Key: $STATESET_NSR_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"grounded_embedding": [
1,
0,
0
],
"name": "WALK",
"program": {
"name": "identity",
"type": "primitive"
}
}'
{
"has_program": true,
"id": 1001,
"name": "Two-Person Tent"
}
Add a symbol to the NSR Machine vocabulary
Creates a new symbol in the system’s vocabulary. Symbols are the atomic units of meaning that the NSR system operates on…
POST
/
api
/
v1
/
nsr
/
symbols
curl --request POST \
--url 'https://api.nsr.stateset.com/api/v1/nsr/symbols' \
--header "X-API-Key: $STATESET_NSR_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"grounded_embedding": [
1,
0,
0
],
"name": "WALK",
"program": {
"name": "identity",
"type": "primitive"
}
}'
{
"has_program": true,
"id": 1001,
"name": "Two-Person Tent"
}
Creates a new symbol in the system’s vocabulary. Symbols are the atomic units
of meaning that the NSR system operates on. Each symbol can optionally have
an associated program that defines its semantic interpretation.
Example
Required scope:
curl -X POST 'https://api.nsr.stateset.com/api/v1/nsr/symbols' \
-H 'X-API-Key: your-api-key' \
-H 'Content-Type: application/json' \
-d '{'name': 'WALK', 'program': {'type': 'primitive', 'name': 'identity'}}'
write
Request body
AddSymbolRequest
Response
SymbolResponse
Status codes
| Code | Meaning |
|---|---|
201 | Symbol added successfully |
400 | Invalid request - empty name or name too long |
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/api/v1/nsr/symbols' \
--header "X-API-Key: $STATESET_NSR_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"grounded_embedding": [
1,
0,
0
],
"name": "WALK",
"program": {
"name": "identity",
"type": "primitive"
}
}'
{
"has_program": true,
"id": 1001,
"name": "Two-Person Tent"
}
Last modified on August 31, 2026