StateSet API Docs

curl --request POST \ --url 'https://api.nsr.stateset.com/api/v1/nsr/symbols' \ --header 'X-API-Key: YOUR_API_KEY' \ --header 'Content-Type: application/json' \ --data '{ "grounded_embedding": [ 1, 0, 0 ], "name": "WALK", "program": { "name": "identity", "type": "primitive" } }'

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

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 '&#123;'name': 'WALK', 'program': &#123;'type': 'primitive', 'name': 'identity'&#125;&#125;'

Required scope: 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: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
  "grounded_embedding": [
    1,
    0,
    0
  ],
  "name": "WALK",
  "program": {
    "name": "identity",
    "type": "primitive"
  }
}'

{
  "has_program": true,
  "id": 1,
  "name": "string"
}

​Request body

​Response

​Status codes

Request body

Response

Status codes