Bundle multiple VSA vectors (superposition/set union)

Required scope: write

POST /api/v1/nsr/vsa/bundle

cURL

curl --request POST \
  --url 'https://api.nsr.stateset.com/api/v1/nsr/vsa/bundle' \
  --header "X-API-Key: $STATESET_NSR_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
  "output_concept": "string",
  "vectors": [
    {
      "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

VSABundleRequest

output_concept · string

Optional concept name to store the bundled result under

vectors · VSAVectorRef[] · required

Vectors to bundle (as concept names or raw vectors)

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	Bundled 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/bundle' \
  --header "X-API-Key: $STATESET_NSR_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
  "output_concept": "string",
  "vectors": [
    {
      "concept": "string"
    }
  ]
}'

200

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