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
number (float)[]
Optional grounded prototype embedding (for emulator centroids / composite symbols).
string
required
Symbol name
object
Response
SymbolResponse
boolean
required
Whether the symbol has an associated program
integer (int64)
required
Symbol ID
string
required
Symbol name
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