Bind two VSA vectors (role-filler composition)

Required scope: write

POST /api/v1/nsr/vsa/bind

cURL

curl --request POST \
  --url 'https://api.nsr.stateset.com/api/v1/nsr/vsa/bind' \
  --header "X-API-Key: $STATESET_NSR_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
  "a": {
    "concept": "string"
  },
  "b": {
    "concept": "string"
  },
  "output_concept": "string"
}'

200

{
  "dimension": 1,
  "enabled": true,
  "results": [
    [
      {
        "0": "s",
        "1": "t",
        "2": "r",
        "3": "i",
        "4": "n",
        "5": "g"
      }
    ]
  ],
  "vector": [
    1.5
  ]
}

Required scope: write

Request body

VSABindRequest

a · VSAVectorRef · required

b · VSAVectorRef · required

output_concept · string

Optional concept name to store the bound result under

Response

VSAResponse

dimension · integer · required

Vector dimension

enabled · boolean · required

Whether VSA is enabled

results · object[][]

Query results (if applicable)

vector · number (float)[]

Result vector (if applicable)

Status codes

Code	Meaning
200	Bound successfully
400	Invalid request
401	Unauthorized — missing or invalid credentials
403	Forbidden — the key/token lacks the required scope
404	Concept not found
429	Rate limited — see Retry-After / X-RateLimit-Reset
503	VSA not enabled

cURL

curl --request POST \
  --url 'https://api.nsr.stateset.com/api/v1/nsr/vsa/bind' \
  --header "X-API-Key: $STATESET_NSR_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
  "a": {
    "concept": "string"
  },
  "b": {
    "concept": "string"
  },
  "output_concept": "string"
}'

200

{
  "dimension": 1,
  "enabled": true,
  "results": [
    [
      {
        "0": "s",
        "1": "t",
        "2": "r",
        "3": "i",
        "4": "n",
        "5": "g"
      }
    ]
  ],
  "vector": [
    1.5
  ]
}